google-apis-adsense_v1_4 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1677 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module AdsenseV1_4
23
+ # AdSense Management API
24
+ #
25
+ # Accesses AdSense publishers' inventory and generates performance reports.
26
+ #
27
+ # @example
28
+ # require 'google/apis/adsense_v1_4'
29
+ #
30
+ # Adsense = Google::Apis::AdsenseV1_4 # Alias the module
31
+ # service = Adsense::AdSenseService.new
32
+ #
33
+ # @see https://developers.google.com/adsense/management/
34
+ class AdSenseService < Google::Apis::Core::BaseService
35
+ # @return [String]
36
+ # API key. Your API key identifies your project and provides you with API access,
37
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
38
+ attr_accessor :key
39
+
40
+ # @return [String]
41
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
42
+ # characters.
43
+ attr_accessor :quota_user
44
+
45
+ # @return [String]
46
+ # Deprecated. Please use quotaUser instead.
47
+ attr_accessor :user_ip
48
+
49
+ def initialize
50
+ super('https://www.googleapis.com/', 'adsense/v1.4/',
51
+ client_name: 'google-apis-adsense_v1_4',
52
+ client_version: Google::Apis::AdsenseV1_4::GEM_VERSION)
53
+ @batch_path = 'batch/adsense/v1.4'
54
+ end
55
+
56
+ # Get information about the selected AdSense account.
57
+ # @param [String] account_id
58
+ # Account to get information about.
59
+ # @param [Boolean] tree
60
+ # Whether the tree of sub accounts should be returned.
61
+ # @param [String] fields
62
+ # Selector specifying which fields to include in a partial response.
63
+ # @param [String] quota_user
64
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
65
+ # characters.
66
+ # @param [String] user_ip
67
+ # Deprecated. Please use quotaUser instead.
68
+ # @param [Google::Apis::RequestOptions] options
69
+ # Request-specific options
70
+ #
71
+ # @yield [result, err] Result & error if block supplied
72
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Account] parsed result object
73
+ # @yieldparam err [StandardError] error object if request failed
74
+ #
75
+ # @return [Google::Apis::AdsenseV1_4::Account]
76
+ #
77
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
78
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
79
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
80
+ def get_account(account_id, tree: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
81
+ command = make_simple_command(:get, 'accounts/{accountId}', options)
82
+ command.response_representation = Google::Apis::AdsenseV1_4::Account::Representation
83
+ command.response_class = Google::Apis::AdsenseV1_4::Account
84
+ command.params['accountId'] = account_id unless account_id.nil?
85
+ command.query['tree'] = tree unless tree.nil?
86
+ command.query['fields'] = fields unless fields.nil?
87
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
88
+ command.query['userIp'] = user_ip unless user_ip.nil?
89
+ execute_or_queue_command(command, &block)
90
+ end
91
+
92
+ # List all accounts available to this AdSense account.
93
+ # @param [Fixnum] max_results
94
+ # The maximum number of accounts to include in the response, used for paging.
95
+ # @param [String] page_token
96
+ # A continuation token, used to page through accounts. To retrieve the next page,
97
+ # set this parameter to the value of "nextPageToken" from the previous response.
98
+ # @param [String] fields
99
+ # Selector specifying which fields to include in a partial response.
100
+ # @param [String] quota_user
101
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
102
+ # characters.
103
+ # @param [String] user_ip
104
+ # Deprecated. Please use quotaUser instead.
105
+ # @param [Google::Apis::RequestOptions] options
106
+ # Request-specific options
107
+ #
108
+ # @yield [result, err] Result & error if block supplied
109
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Accounts] parsed result object
110
+ # @yieldparam err [StandardError] error object if request failed
111
+ #
112
+ # @return [Google::Apis::AdsenseV1_4::Accounts]
113
+ #
114
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
115
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
116
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
117
+ def list_accounts(max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
118
+ command = make_simple_command(:get, 'accounts', options)
119
+ command.response_representation = Google::Apis::AdsenseV1_4::Accounts::Representation
120
+ command.response_class = Google::Apis::AdsenseV1_4::Accounts
121
+ command.query['maxResults'] = max_results unless max_results.nil?
122
+ command.query['pageToken'] = page_token unless page_token.nil?
123
+ command.query['fields'] = fields unless fields.nil?
124
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
125
+ command.query['userIp'] = user_ip unless user_ip.nil?
126
+ execute_or_queue_command(command, &block)
127
+ end
128
+
129
+ # Get Auto ad code for a given ad client.
130
+ # @param [String] account_id
131
+ # Account which contains the ad client.
132
+ # @param [String] ad_client_id
133
+ # Ad client to get the code for.
134
+ # @param [String] tag_partner
135
+ # Tag partner to include in the ad code snippet.
136
+ # @param [String] fields
137
+ # Selector specifying which fields to include in a partial response.
138
+ # @param [String] quota_user
139
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
140
+ # characters.
141
+ # @param [String] user_ip
142
+ # Deprecated. Please use quotaUser instead.
143
+ # @param [Google::Apis::RequestOptions] options
144
+ # Request-specific options
145
+ #
146
+ # @yield [result, err] Result & error if block supplied
147
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdCode] parsed result object
148
+ # @yieldparam err [StandardError] error object if request failed
149
+ #
150
+ # @return [Google::Apis::AdsenseV1_4::AdCode]
151
+ #
152
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
153
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
154
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
155
+ def get_account_adclient_ad_code(account_id, ad_client_id, tag_partner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
156
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/adcode', options)
157
+ command.response_representation = Google::Apis::AdsenseV1_4::AdCode::Representation
158
+ command.response_class = Google::Apis::AdsenseV1_4::AdCode
159
+ command.params['accountId'] = account_id unless account_id.nil?
160
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
161
+ command.query['tagPartner'] = tag_partner unless tag_partner.nil?
162
+ command.query['fields'] = fields unless fields.nil?
163
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
164
+ command.query['userIp'] = user_ip unless user_ip.nil?
165
+ execute_or_queue_command(command, &block)
166
+ end
167
+
168
+ # List all ad clients in the specified account.
169
+ # @param [String] account_id
170
+ # Account for which to list ad clients.
171
+ # @param [Fixnum] max_results
172
+ # The maximum number of ad clients to include in the response, used for paging.
173
+ # @param [String] page_token
174
+ # A continuation token, used to page through ad clients. To retrieve the next
175
+ # page, set this parameter to the value of "nextPageToken" from the previous
176
+ # response.
177
+ # @param [String] fields
178
+ # Selector specifying which fields to include in a partial response.
179
+ # @param [String] quota_user
180
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
181
+ # characters.
182
+ # @param [String] user_ip
183
+ # Deprecated. Please use quotaUser instead.
184
+ # @param [Google::Apis::RequestOptions] options
185
+ # Request-specific options
186
+ #
187
+ # @yield [result, err] Result & error if block supplied
188
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdClients] parsed result object
189
+ # @yieldparam err [StandardError] error object if request failed
190
+ #
191
+ # @return [Google::Apis::AdsenseV1_4::AdClients]
192
+ #
193
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
194
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
195
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
196
+ def list_account_ad_clients(account_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
197
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients', options)
198
+ command.response_representation = Google::Apis::AdsenseV1_4::AdClients::Representation
199
+ command.response_class = Google::Apis::AdsenseV1_4::AdClients
200
+ command.params['accountId'] = account_id unless account_id.nil?
201
+ command.query['maxResults'] = max_results unless max_results.nil?
202
+ command.query['pageToken'] = page_token unless page_token.nil?
203
+ command.query['fields'] = fields unless fields.nil?
204
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
205
+ command.query['userIp'] = user_ip unless user_ip.nil?
206
+ execute_or_queue_command(command, &block)
207
+ end
208
+
209
+ # Gets the specified ad unit in the specified ad client for the specified
210
+ # account.
211
+ # @param [String] account_id
212
+ # Account to which the ad client belongs.
213
+ # @param [String] ad_client_id
214
+ # Ad client for which to get the ad unit.
215
+ # @param [String] ad_unit_id
216
+ # Ad unit to retrieve.
217
+ # @param [String] fields
218
+ # Selector specifying which fields to include in a partial response.
219
+ # @param [String] quota_user
220
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
221
+ # characters.
222
+ # @param [String] user_ip
223
+ # Deprecated. Please use quotaUser instead.
224
+ # @param [Google::Apis::RequestOptions] options
225
+ # Request-specific options
226
+ #
227
+ # @yield [result, err] Result & error if block supplied
228
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnit] parsed result object
229
+ # @yieldparam err [StandardError] error object if request failed
230
+ #
231
+ # @return [Google::Apis::AdsenseV1_4::AdUnit]
232
+ #
233
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
234
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
235
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
236
+ def get_account_ad_unit(account_id, ad_client_id, ad_unit_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
237
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}', options)
238
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnit::Representation
239
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnit
240
+ command.params['accountId'] = account_id unless account_id.nil?
241
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
242
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
243
+ command.query['fields'] = fields unless fields.nil?
244
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
245
+ command.query['userIp'] = user_ip unless user_ip.nil?
246
+ execute_or_queue_command(command, &block)
247
+ end
248
+
249
+ # Get ad code for the specified ad unit.
250
+ # @param [String] account_id
251
+ # Account which contains the ad client.
252
+ # @param [String] ad_client_id
253
+ # Ad client with contains the ad unit.
254
+ # @param [String] ad_unit_id
255
+ # Ad unit to get the code for.
256
+ # @param [String] fields
257
+ # Selector specifying which fields to include in a partial response.
258
+ # @param [String] quota_user
259
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
260
+ # characters.
261
+ # @param [String] user_ip
262
+ # Deprecated. Please use quotaUser instead.
263
+ # @param [Google::Apis::RequestOptions] options
264
+ # Request-specific options
265
+ #
266
+ # @yield [result, err] Result & error if block supplied
267
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdCode] parsed result object
268
+ # @yieldparam err [StandardError] error object if request failed
269
+ #
270
+ # @return [Google::Apis::AdsenseV1_4::AdCode]
271
+ #
272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
275
+ def get_account_ad_unit_ad_code(account_id, ad_client_id, ad_unit_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
276
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}/adcode', options)
277
+ command.response_representation = Google::Apis::AdsenseV1_4::AdCode::Representation
278
+ command.response_class = Google::Apis::AdsenseV1_4::AdCode
279
+ command.params['accountId'] = account_id unless account_id.nil?
280
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
281
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
282
+ command.query['fields'] = fields unless fields.nil?
283
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
284
+ command.query['userIp'] = user_ip unless user_ip.nil?
285
+ execute_or_queue_command(command, &block)
286
+ end
287
+
288
+ # List all ad units in the specified ad client for the specified account.
289
+ # @param [String] account_id
290
+ # Account to which the ad client belongs.
291
+ # @param [String] ad_client_id
292
+ # Ad client for which to list ad units.
293
+ # @param [Boolean] include_inactive
294
+ # Whether to include inactive ad units. Default: true.
295
+ # @param [Fixnum] max_results
296
+ # The maximum number of ad units to include in the response, used for paging.
297
+ # @param [String] page_token
298
+ # A continuation token, used to page through ad units. To retrieve the next page,
299
+ # set this parameter to the value of "nextPageToken" from the previous response.
300
+ # @param [String] fields
301
+ # Selector specifying which fields to include in a partial response.
302
+ # @param [String] quota_user
303
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
304
+ # characters.
305
+ # @param [String] user_ip
306
+ # Deprecated. Please use quotaUser instead.
307
+ # @param [Google::Apis::RequestOptions] options
308
+ # Request-specific options
309
+ #
310
+ # @yield [result, err] Result & error if block supplied
311
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnits] parsed result object
312
+ # @yieldparam err [StandardError] error object if request failed
313
+ #
314
+ # @return [Google::Apis::AdsenseV1_4::AdUnits]
315
+ #
316
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
317
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
318
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
319
+ def list_account_ad_units(account_id, ad_client_id, include_inactive: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
320
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/adunits', options)
321
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnits::Representation
322
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnits
323
+ command.params['accountId'] = account_id unless account_id.nil?
324
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
325
+ command.query['includeInactive'] = include_inactive unless include_inactive.nil?
326
+ command.query['maxResults'] = max_results unless max_results.nil?
327
+ command.query['pageToken'] = page_token unless page_token.nil?
328
+ command.query['fields'] = fields unless fields.nil?
329
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
330
+ command.query['userIp'] = user_ip unless user_ip.nil?
331
+ execute_or_queue_command(command, &block)
332
+ end
333
+
334
+ # List all custom channels which the specified ad unit belongs to.
335
+ # @param [String] account_id
336
+ # Account to which the ad client belongs.
337
+ # @param [String] ad_client_id
338
+ # Ad client which contains the ad unit.
339
+ # @param [String] ad_unit_id
340
+ # Ad unit for which to list custom channels.
341
+ # @param [Fixnum] max_results
342
+ # The maximum number of custom channels to include in the response, used for
343
+ # paging.
344
+ # @param [String] page_token
345
+ # A continuation token, used to page through custom channels. To retrieve the
346
+ # next page, set this parameter to the value of "nextPageToken" from the
347
+ # previous response.
348
+ # @param [String] fields
349
+ # Selector specifying which fields to include in a partial response.
350
+ # @param [String] quota_user
351
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
352
+ # characters.
353
+ # @param [String] user_ip
354
+ # Deprecated. Please use quotaUser instead.
355
+ # @param [Google::Apis::RequestOptions] options
356
+ # Request-specific options
357
+ #
358
+ # @yield [result, err] Result & error if block supplied
359
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannels] parsed result object
360
+ # @yieldparam err [StandardError] error object if request failed
361
+ #
362
+ # @return [Google::Apis::AdsenseV1_4::CustomChannels]
363
+ #
364
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
365
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
366
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
367
+ def list_account_ad_unit_custom_channels(account_id, ad_client_id, ad_unit_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
368
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/adunits/{adUnitId}/customchannels', options)
369
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannels::Representation
370
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannels
371
+ command.params['accountId'] = account_id unless account_id.nil?
372
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
373
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
374
+ command.query['maxResults'] = max_results unless max_results.nil?
375
+ command.query['pageToken'] = page_token unless page_token.nil?
376
+ command.query['fields'] = fields unless fields.nil?
377
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
378
+ command.query['userIp'] = user_ip unless user_ip.nil?
379
+ execute_or_queue_command(command, &block)
380
+ end
381
+
382
+ # Dismiss (delete) the specified alert from the specified publisher AdSense
383
+ # account.
384
+ # @param [String] account_id
385
+ # Account which contains the ad unit.
386
+ # @param [String] alert_id
387
+ # Alert to delete.
388
+ # @param [String] fields
389
+ # Selector specifying which fields to include in a partial response.
390
+ # @param [String] quota_user
391
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
392
+ # characters.
393
+ # @param [String] user_ip
394
+ # Deprecated. Please use quotaUser instead.
395
+ # @param [Google::Apis::RequestOptions] options
396
+ # Request-specific options
397
+ #
398
+ # @yield [result, err] Result & error if block supplied
399
+ # @yieldparam result [NilClass] No result returned for this method
400
+ # @yieldparam err [StandardError] error object if request failed
401
+ #
402
+ # @return [void]
403
+ #
404
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
405
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
406
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
407
+ def delete_account_alert(account_id, alert_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
408
+ command = make_simple_command(:delete, 'accounts/{accountId}/alerts/{alertId}', options)
409
+ command.params['accountId'] = account_id unless account_id.nil?
410
+ command.params['alertId'] = alert_id unless alert_id.nil?
411
+ command.query['fields'] = fields unless fields.nil?
412
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
413
+ command.query['userIp'] = user_ip unless user_ip.nil?
414
+ execute_or_queue_command(command, &block)
415
+ end
416
+
417
+ # List the alerts for the specified AdSense account.
418
+ # @param [String] account_id
419
+ # Account for which to retrieve the alerts.
420
+ # @param [String] locale
421
+ # The locale to use for translating alert messages. The account locale will be
422
+ # used if this is not supplied. The AdSense default (English) will be used if
423
+ # the supplied locale is invalid or unsupported.
424
+ # @param [String] fields
425
+ # Selector specifying which fields to include in a partial response.
426
+ # @param [String] quota_user
427
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
428
+ # characters.
429
+ # @param [String] user_ip
430
+ # Deprecated. Please use quotaUser instead.
431
+ # @param [Google::Apis::RequestOptions] options
432
+ # Request-specific options
433
+ #
434
+ # @yield [result, err] Result & error if block supplied
435
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Alerts] parsed result object
436
+ # @yieldparam err [StandardError] error object if request failed
437
+ #
438
+ # @return [Google::Apis::AdsenseV1_4::Alerts]
439
+ #
440
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
441
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
442
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
443
+ def list_account_alerts(account_id, locale: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
444
+ command = make_simple_command(:get, 'accounts/{accountId}/alerts', options)
445
+ command.response_representation = Google::Apis::AdsenseV1_4::Alerts::Representation
446
+ command.response_class = Google::Apis::AdsenseV1_4::Alerts
447
+ command.params['accountId'] = account_id unless account_id.nil?
448
+ command.query['locale'] = locale unless locale.nil?
449
+ command.query['fields'] = fields unless fields.nil?
450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
451
+ command.query['userIp'] = user_ip unless user_ip.nil?
452
+ execute_or_queue_command(command, &block)
453
+ end
454
+
455
+ # Get the specified custom channel from the specified ad client for the
456
+ # specified account.
457
+ # @param [String] account_id
458
+ # Account to which the ad client belongs.
459
+ # @param [String] ad_client_id
460
+ # Ad client which contains the custom channel.
461
+ # @param [String] custom_channel_id
462
+ # Custom channel to retrieve.
463
+ # @param [String] fields
464
+ # Selector specifying which fields to include in a partial response.
465
+ # @param [String] quota_user
466
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
467
+ # characters.
468
+ # @param [String] user_ip
469
+ # Deprecated. Please use quotaUser instead.
470
+ # @param [Google::Apis::RequestOptions] options
471
+ # Request-specific options
472
+ #
473
+ # @yield [result, err] Result & error if block supplied
474
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannel] parsed result object
475
+ # @yieldparam err [StandardError] error object if request failed
476
+ #
477
+ # @return [Google::Apis::AdsenseV1_4::CustomChannel]
478
+ #
479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
482
+ def get_account_custom_channel(account_id, ad_client_id, custom_channel_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
483
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/customchannels/{customChannelId}', options)
484
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannel::Representation
485
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannel
486
+ command.params['accountId'] = account_id unless account_id.nil?
487
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
488
+ command.params['customChannelId'] = custom_channel_id unless custom_channel_id.nil?
489
+ command.query['fields'] = fields unless fields.nil?
490
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
491
+ command.query['userIp'] = user_ip unless user_ip.nil?
492
+ execute_or_queue_command(command, &block)
493
+ end
494
+
495
+ # List all custom channels in the specified ad client for the specified account.
496
+ # @param [String] account_id
497
+ # Account to which the ad client belongs.
498
+ # @param [String] ad_client_id
499
+ # Ad client for which to list custom channels.
500
+ # @param [Fixnum] max_results
501
+ # The maximum number of custom channels to include in the response, used for
502
+ # paging.
503
+ # @param [String] page_token
504
+ # A continuation token, used to page through custom channels. To retrieve the
505
+ # next page, set this parameter to the value of "nextPageToken" from the
506
+ # previous response.
507
+ # @param [String] fields
508
+ # Selector specifying which fields to include in a partial response.
509
+ # @param [String] quota_user
510
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
511
+ # characters.
512
+ # @param [String] user_ip
513
+ # Deprecated. Please use quotaUser instead.
514
+ # @param [Google::Apis::RequestOptions] options
515
+ # Request-specific options
516
+ #
517
+ # @yield [result, err] Result & error if block supplied
518
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannels] parsed result object
519
+ # @yieldparam err [StandardError] error object if request failed
520
+ #
521
+ # @return [Google::Apis::AdsenseV1_4::CustomChannels]
522
+ #
523
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
524
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
525
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
526
+ def list_account_custom_channels(account_id, ad_client_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
527
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/customchannels', options)
528
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannels::Representation
529
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannels
530
+ command.params['accountId'] = account_id unless account_id.nil?
531
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
532
+ command.query['maxResults'] = max_results unless max_results.nil?
533
+ command.query['pageToken'] = page_token unless page_token.nil?
534
+ command.query['fields'] = fields unless fields.nil?
535
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
536
+ command.query['userIp'] = user_ip unless user_ip.nil?
537
+ execute_or_queue_command(command, &block)
538
+ end
539
+
540
+ # List all ad units in the specified custom channel.
541
+ # @param [String] account_id
542
+ # Account to which the ad client belongs.
543
+ # @param [String] ad_client_id
544
+ # Ad client which contains the custom channel.
545
+ # @param [String] custom_channel_id
546
+ # Custom channel for which to list ad units.
547
+ # @param [Boolean] include_inactive
548
+ # Whether to include inactive ad units. Default: true.
549
+ # @param [Fixnum] max_results
550
+ # The maximum number of ad units to include in the response, used for paging.
551
+ # @param [String] page_token
552
+ # A continuation token, used to page through ad units. To retrieve the next page,
553
+ # set this parameter to the value of "nextPageToken" from the previous response.
554
+ # @param [String] fields
555
+ # Selector specifying which fields to include in a partial response.
556
+ # @param [String] quota_user
557
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
558
+ # characters.
559
+ # @param [String] user_ip
560
+ # Deprecated. Please use quotaUser instead.
561
+ # @param [Google::Apis::RequestOptions] options
562
+ # Request-specific options
563
+ #
564
+ # @yield [result, err] Result & error if block supplied
565
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnits] parsed result object
566
+ # @yieldparam err [StandardError] error object if request failed
567
+ #
568
+ # @return [Google::Apis::AdsenseV1_4::AdUnits]
569
+ #
570
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
571
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
572
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
573
+ def list_account_custom_channel_ad_units(account_id, ad_client_id, custom_channel_id, include_inactive: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
574
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/customchannels/{customChannelId}/adunits', options)
575
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnits::Representation
576
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnits
577
+ command.params['accountId'] = account_id unless account_id.nil?
578
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
579
+ command.params['customChannelId'] = custom_channel_id unless custom_channel_id.nil?
580
+ command.query['includeInactive'] = include_inactive unless include_inactive.nil?
581
+ command.query['maxResults'] = max_results unless max_results.nil?
582
+ command.query['pageToken'] = page_token unless page_token.nil?
583
+ command.query['fields'] = fields unless fields.nil?
584
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
585
+ command.query['userIp'] = user_ip unless user_ip.nil?
586
+ execute_or_queue_command(command, &block)
587
+ end
588
+
589
+ # List the payments for the specified AdSense account.
590
+ # @param [String] account_id
591
+ # Account for which to retrieve the payments.
592
+ # @param [String] fields
593
+ # Selector specifying which fields to include in a partial response.
594
+ # @param [String] quota_user
595
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
596
+ # characters.
597
+ # @param [String] user_ip
598
+ # Deprecated. Please use quotaUser instead.
599
+ # @param [Google::Apis::RequestOptions] options
600
+ # Request-specific options
601
+ #
602
+ # @yield [result, err] Result & error if block supplied
603
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Payments] parsed result object
604
+ # @yieldparam err [StandardError] error object if request failed
605
+ #
606
+ # @return [Google::Apis::AdsenseV1_4::Payments]
607
+ #
608
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
609
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
610
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
611
+ def list_account_payments(account_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
612
+ command = make_simple_command(:get, 'accounts/{accountId}/payments', options)
613
+ command.response_representation = Google::Apis::AdsenseV1_4::Payments::Representation
614
+ command.response_class = Google::Apis::AdsenseV1_4::Payments
615
+ command.params['accountId'] = account_id unless account_id.nil?
616
+ command.query['fields'] = fields unless fields.nil?
617
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
618
+ command.query['userIp'] = user_ip unless user_ip.nil?
619
+ execute_or_queue_command(command, &block)
620
+ end
621
+
622
+ # Generate an AdSense report based on the report request sent in the query
623
+ # parameters. Returns the result as JSON; to retrieve output in CSV format
624
+ # specify "alt=csv" as a query parameter.
625
+ # @param [String] account_id
626
+ # Account upon which to report.
627
+ # @param [String] start_date
628
+ # Start of the date range to report on in "YYYY-MM-DD" format, inclusive.
629
+ # @param [String] end_date
630
+ # End of the date range to report on in "YYYY-MM-DD" format, inclusive.
631
+ # @param [String] currency
632
+ # Optional currency to use when reporting on monetary metrics. Defaults to the
633
+ # account's currency if not set.
634
+ # @param [Array<String>, String] dimension
635
+ # Dimensions to base the report on.
636
+ # @param [Array<String>, String] filter
637
+ # Filters to be run on the report.
638
+ # @param [String] locale
639
+ # Optional locale to use for translating report output to a local language.
640
+ # Defaults to "en_US" if not specified.
641
+ # @param [Fixnum] max_results
642
+ # The maximum number of rows of report data to return.
643
+ # @param [Array<String>, String] metric
644
+ # Numeric columns to include in the report.
645
+ # @param [Array<String>, String] sort
646
+ # The name of a dimension or metric to sort the resulting report on, optionally
647
+ # prefixed with "+" to sort ascending or "-" to sort descending. If no prefix is
648
+ # specified, the column is sorted ascending.
649
+ # @param [Fixnum] start_index
650
+ # Index of the first row of report data to return.
651
+ # @param [Boolean] use_timezone_reporting
652
+ # Whether the report should be generated in the AdSense account's local timezone.
653
+ # If false default PST/PDT timezone will be used.
654
+ # @param [String] fields
655
+ # Selector specifying which fields to include in a partial response.
656
+ # @param [String] quota_user
657
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
658
+ # characters.
659
+ # @param [String] user_ip
660
+ # Deprecated. Please use quotaUser instead.
661
+ # @param [IO, String] download_dest
662
+ # IO stream or filename to receive content download
663
+ # @param [Google::Apis::RequestOptions] options
664
+ # Request-specific options
665
+ #
666
+ # @yield [result, err] Result & error if block supplied
667
+ # @yieldparam result [Google::Apis::AdsenseV1_4::GenerateReportResponse] parsed result object
668
+ # @yieldparam err [StandardError] error object if request failed
669
+ #
670
+ # @return [Google::Apis::AdsenseV1_4::GenerateReportResponse]
671
+ #
672
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
673
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
674
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
675
+ def generate_account_report(account_id, start_date, end_date, currency: nil, dimension: nil, filter: nil, locale: nil, max_results: nil, metric: nil, sort: nil, start_index: nil, use_timezone_reporting: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
676
+ if download_dest.nil?
677
+ command = make_simple_command(:get, 'accounts/{accountId}/reports', options)
678
+ else
679
+ command = make_download_command(:get, 'accounts/{accountId}/reports', options)
680
+ command.download_dest = download_dest
681
+ end
682
+ command.response_representation = Google::Apis::AdsenseV1_4::GenerateReportResponse::Representation
683
+ command.response_class = Google::Apis::AdsenseV1_4::GenerateReportResponse
684
+ command.params['accountId'] = account_id unless account_id.nil?
685
+ command.query['currency'] = currency unless currency.nil?
686
+ command.query['dimension'] = dimension unless dimension.nil?
687
+ command.query['endDate'] = end_date unless end_date.nil?
688
+ command.query['filter'] = filter unless filter.nil?
689
+ command.query['locale'] = locale unless locale.nil?
690
+ command.query['maxResults'] = max_results unless max_results.nil?
691
+ command.query['metric'] = metric unless metric.nil?
692
+ command.query['sort'] = sort unless sort.nil?
693
+ command.query['startDate'] = start_date unless start_date.nil?
694
+ command.query['startIndex'] = start_index unless start_index.nil?
695
+ command.query['useTimezoneReporting'] = use_timezone_reporting unless use_timezone_reporting.nil?
696
+ command.query['fields'] = fields unless fields.nil?
697
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
698
+ command.query['userIp'] = user_ip unless user_ip.nil?
699
+ execute_or_queue_command(command, &block)
700
+ end
701
+
702
+ # Generate an AdSense report based on the saved report ID sent in the query
703
+ # parameters.
704
+ # @param [String] account_id
705
+ # Account to which the saved reports belong.
706
+ # @param [String] saved_report_id
707
+ # The saved report to retrieve.
708
+ # @param [String] locale
709
+ # Optional locale to use for translating report output to a local language.
710
+ # Defaults to "en_US" if not specified.
711
+ # @param [Fixnum] max_results
712
+ # The maximum number of rows of report data to return.
713
+ # @param [Fixnum] start_index
714
+ # Index of the first row of report data to return.
715
+ # @param [String] fields
716
+ # Selector specifying which fields to include in a partial response.
717
+ # @param [String] quota_user
718
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
719
+ # characters.
720
+ # @param [String] user_ip
721
+ # Deprecated. Please use quotaUser instead.
722
+ # @param [Google::Apis::RequestOptions] options
723
+ # Request-specific options
724
+ #
725
+ # @yield [result, err] Result & error if block supplied
726
+ # @yieldparam result [Google::Apis::AdsenseV1_4::GenerateReportResponse] parsed result object
727
+ # @yieldparam err [StandardError] error object if request failed
728
+ #
729
+ # @return [Google::Apis::AdsenseV1_4::GenerateReportResponse]
730
+ #
731
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
732
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
733
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
734
+ def generate_account_saved_report(account_id, saved_report_id, locale: nil, max_results: nil, start_index: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
735
+ command = make_simple_command(:get, 'accounts/{accountId}/reports/{savedReportId}', options)
736
+ command.response_representation = Google::Apis::AdsenseV1_4::GenerateReportResponse::Representation
737
+ command.response_class = Google::Apis::AdsenseV1_4::GenerateReportResponse
738
+ command.params['accountId'] = account_id unless account_id.nil?
739
+ command.params['savedReportId'] = saved_report_id unless saved_report_id.nil?
740
+ command.query['locale'] = locale unless locale.nil?
741
+ command.query['maxResults'] = max_results unless max_results.nil?
742
+ command.query['startIndex'] = start_index unless start_index.nil?
743
+ command.query['fields'] = fields unless fields.nil?
744
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
745
+ command.query['userIp'] = user_ip unless user_ip.nil?
746
+ execute_or_queue_command(command, &block)
747
+ end
748
+
749
+ # List all saved reports in the specified AdSense account.
750
+ # @param [String] account_id
751
+ # Account to which the saved reports belong.
752
+ # @param [Fixnum] max_results
753
+ # The maximum number of saved reports to include in the response, used for
754
+ # paging.
755
+ # @param [String] page_token
756
+ # A continuation token, used to page through saved reports. To retrieve the next
757
+ # page, set this parameter to the value of "nextPageToken" from the previous
758
+ # response.
759
+ # @param [String] fields
760
+ # Selector specifying which fields to include in a partial response.
761
+ # @param [String] quota_user
762
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
763
+ # characters.
764
+ # @param [String] user_ip
765
+ # Deprecated. Please use quotaUser instead.
766
+ # @param [Google::Apis::RequestOptions] options
767
+ # Request-specific options
768
+ #
769
+ # @yield [result, err] Result & error if block supplied
770
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedReports] parsed result object
771
+ # @yieldparam err [StandardError] error object if request failed
772
+ #
773
+ # @return [Google::Apis::AdsenseV1_4::SavedReports]
774
+ #
775
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
776
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
777
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
778
+ def list_account_saved_reports(account_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
779
+ command = make_simple_command(:get, 'accounts/{accountId}/reports/saved', options)
780
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedReports::Representation
781
+ command.response_class = Google::Apis::AdsenseV1_4::SavedReports
782
+ command.params['accountId'] = account_id unless account_id.nil?
783
+ command.query['maxResults'] = max_results unless max_results.nil?
784
+ command.query['pageToken'] = page_token unless page_token.nil?
785
+ command.query['fields'] = fields unless fields.nil?
786
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
787
+ command.query['userIp'] = user_ip unless user_ip.nil?
788
+ execute_or_queue_command(command, &block)
789
+ end
790
+
791
+ # List a specific saved ad style for the specified account.
792
+ # @param [String] account_id
793
+ # Account for which to get the saved ad style.
794
+ # @param [String] saved_ad_style_id
795
+ # Saved ad style to retrieve.
796
+ # @param [String] fields
797
+ # Selector specifying which fields to include in a partial response.
798
+ # @param [String] quota_user
799
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
800
+ # characters.
801
+ # @param [String] user_ip
802
+ # Deprecated. Please use quotaUser instead.
803
+ # @param [Google::Apis::RequestOptions] options
804
+ # Request-specific options
805
+ #
806
+ # @yield [result, err] Result & error if block supplied
807
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedAdStyle] parsed result object
808
+ # @yieldparam err [StandardError] error object if request failed
809
+ #
810
+ # @return [Google::Apis::AdsenseV1_4::SavedAdStyle]
811
+ #
812
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
813
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
814
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
815
+ def get_account_saved_ad_style(account_id, saved_ad_style_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
816
+ command = make_simple_command(:get, 'accounts/{accountId}/savedadstyles/{savedAdStyleId}', options)
817
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedAdStyle::Representation
818
+ command.response_class = Google::Apis::AdsenseV1_4::SavedAdStyle
819
+ command.params['accountId'] = account_id unless account_id.nil?
820
+ command.params['savedAdStyleId'] = saved_ad_style_id unless saved_ad_style_id.nil?
821
+ command.query['fields'] = fields unless fields.nil?
822
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
823
+ command.query['userIp'] = user_ip unless user_ip.nil?
824
+ execute_or_queue_command(command, &block)
825
+ end
826
+
827
+ # List all saved ad styles in the specified account.
828
+ # @param [String] account_id
829
+ # Account for which to list saved ad styles.
830
+ # @param [Fixnum] max_results
831
+ # The maximum number of saved ad styles to include in the response, used for
832
+ # paging.
833
+ # @param [String] page_token
834
+ # A continuation token, used to page through saved ad styles. To retrieve the
835
+ # next page, set this parameter to the value of "nextPageToken" from the
836
+ # previous response.
837
+ # @param [String] fields
838
+ # Selector specifying which fields to include in a partial response.
839
+ # @param [String] quota_user
840
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
841
+ # characters.
842
+ # @param [String] user_ip
843
+ # Deprecated. Please use quotaUser instead.
844
+ # @param [Google::Apis::RequestOptions] options
845
+ # Request-specific options
846
+ #
847
+ # @yield [result, err] Result & error if block supplied
848
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedAdStyles] parsed result object
849
+ # @yieldparam err [StandardError] error object if request failed
850
+ #
851
+ # @return [Google::Apis::AdsenseV1_4::SavedAdStyles]
852
+ #
853
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
854
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
855
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
856
+ def list_account_saved_ad_styles(account_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
857
+ command = make_simple_command(:get, 'accounts/{accountId}/savedadstyles', options)
858
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedAdStyles::Representation
859
+ command.response_class = Google::Apis::AdsenseV1_4::SavedAdStyles
860
+ command.params['accountId'] = account_id unless account_id.nil?
861
+ command.query['maxResults'] = max_results unless max_results.nil?
862
+ command.query['pageToken'] = page_token unless page_token.nil?
863
+ command.query['fields'] = fields unless fields.nil?
864
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
865
+ command.query['userIp'] = user_ip unless user_ip.nil?
866
+ execute_or_queue_command(command, &block)
867
+ end
868
+
869
+ # List all URL channels in the specified ad client for the specified account.
870
+ # @param [String] account_id
871
+ # Account to which the ad client belongs.
872
+ # @param [String] ad_client_id
873
+ # Ad client for which to list URL channels.
874
+ # @param [Fixnum] max_results
875
+ # The maximum number of URL channels to include in the response, used for paging.
876
+ # @param [String] page_token
877
+ # A continuation token, used to page through URL channels. To retrieve the next
878
+ # page, set this parameter to the value of "nextPageToken" from the previous
879
+ # response.
880
+ # @param [String] fields
881
+ # Selector specifying which fields to include in a partial response.
882
+ # @param [String] quota_user
883
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
884
+ # characters.
885
+ # @param [String] user_ip
886
+ # Deprecated. Please use quotaUser instead.
887
+ # @param [Google::Apis::RequestOptions] options
888
+ # Request-specific options
889
+ #
890
+ # @yield [result, err] Result & error if block supplied
891
+ # @yieldparam result [Google::Apis::AdsenseV1_4::UrlChannels] parsed result object
892
+ # @yieldparam err [StandardError] error object if request failed
893
+ #
894
+ # @return [Google::Apis::AdsenseV1_4::UrlChannels]
895
+ #
896
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
897
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
898
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
899
+ def list_account_url_channels(account_id, ad_client_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
900
+ command = make_simple_command(:get, 'accounts/{accountId}/adclients/{adClientId}/urlchannels', options)
901
+ command.response_representation = Google::Apis::AdsenseV1_4::UrlChannels::Representation
902
+ command.response_class = Google::Apis::AdsenseV1_4::UrlChannels
903
+ command.params['accountId'] = account_id unless account_id.nil?
904
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
905
+ command.query['maxResults'] = max_results unless max_results.nil?
906
+ command.query['pageToken'] = page_token unless page_token.nil?
907
+ command.query['fields'] = fields unless fields.nil?
908
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
909
+ command.query['userIp'] = user_ip unless user_ip.nil?
910
+ execute_or_queue_command(command, &block)
911
+ end
912
+
913
+ # List all ad clients in this AdSense account.
914
+ # @param [Fixnum] max_results
915
+ # The maximum number of ad clients to include in the response, used for paging.
916
+ # @param [String] page_token
917
+ # A continuation token, used to page through ad clients. To retrieve the next
918
+ # page, set this parameter to the value of "nextPageToken" from the previous
919
+ # response.
920
+ # @param [String] fields
921
+ # Selector specifying which fields to include in a partial response.
922
+ # @param [String] quota_user
923
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
924
+ # characters.
925
+ # @param [String] user_ip
926
+ # Deprecated. Please use quotaUser instead.
927
+ # @param [Google::Apis::RequestOptions] options
928
+ # Request-specific options
929
+ #
930
+ # @yield [result, err] Result & error if block supplied
931
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdClients] parsed result object
932
+ # @yieldparam err [StandardError] error object if request failed
933
+ #
934
+ # @return [Google::Apis::AdsenseV1_4::AdClients]
935
+ #
936
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
937
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
938
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
939
+ def list_ad_clients(max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
940
+ command = make_simple_command(:get, 'adclients', options)
941
+ command.response_representation = Google::Apis::AdsenseV1_4::AdClients::Representation
942
+ command.response_class = Google::Apis::AdsenseV1_4::AdClients
943
+ command.query['maxResults'] = max_results unless max_results.nil?
944
+ command.query['pageToken'] = page_token unless page_token.nil?
945
+ command.query['fields'] = fields unless fields.nil?
946
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
947
+ command.query['userIp'] = user_ip unless user_ip.nil?
948
+ execute_or_queue_command(command, &block)
949
+ end
950
+
951
+ # Gets the specified ad unit in the specified ad client.
952
+ # @param [String] ad_client_id
953
+ # Ad client for which to get the ad unit.
954
+ # @param [String] ad_unit_id
955
+ # Ad unit to retrieve.
956
+ # @param [String] fields
957
+ # Selector specifying which fields to include in a partial response.
958
+ # @param [String] quota_user
959
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
960
+ # characters.
961
+ # @param [String] user_ip
962
+ # Deprecated. Please use quotaUser instead.
963
+ # @param [Google::Apis::RequestOptions] options
964
+ # Request-specific options
965
+ #
966
+ # @yield [result, err] Result & error if block supplied
967
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnit] parsed result object
968
+ # @yieldparam err [StandardError] error object if request failed
969
+ #
970
+ # @return [Google::Apis::AdsenseV1_4::AdUnit]
971
+ #
972
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
973
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
974
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
975
+ def get_ad_unit(ad_client_id, ad_unit_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
976
+ command = make_simple_command(:get, 'adclients/{adClientId}/adunits/{adUnitId}', options)
977
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnit::Representation
978
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnit
979
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
980
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
981
+ command.query['fields'] = fields unless fields.nil?
982
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
983
+ command.query['userIp'] = user_ip unless user_ip.nil?
984
+ execute_or_queue_command(command, &block)
985
+ end
986
+
987
+ # Get ad code for the specified ad unit.
988
+ # @param [String] ad_client_id
989
+ # Ad client with contains the ad unit.
990
+ # @param [String] ad_unit_id
991
+ # Ad unit to get the code for.
992
+ # @param [String] fields
993
+ # Selector specifying which fields to include in a partial response.
994
+ # @param [String] quota_user
995
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
996
+ # characters.
997
+ # @param [String] user_ip
998
+ # Deprecated. Please use quotaUser instead.
999
+ # @param [Google::Apis::RequestOptions] options
1000
+ # Request-specific options
1001
+ #
1002
+ # @yield [result, err] Result & error if block supplied
1003
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdCode] parsed result object
1004
+ # @yieldparam err [StandardError] error object if request failed
1005
+ #
1006
+ # @return [Google::Apis::AdsenseV1_4::AdCode]
1007
+ #
1008
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1009
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1010
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1011
+ def get_ad_code_ad_unit(ad_client_id, ad_unit_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1012
+ command = make_simple_command(:get, 'adclients/{adClientId}/adunits/{adUnitId}/adcode', options)
1013
+ command.response_representation = Google::Apis::AdsenseV1_4::AdCode::Representation
1014
+ command.response_class = Google::Apis::AdsenseV1_4::AdCode
1015
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1016
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
1017
+ command.query['fields'] = fields unless fields.nil?
1018
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1019
+ command.query['userIp'] = user_ip unless user_ip.nil?
1020
+ execute_or_queue_command(command, &block)
1021
+ end
1022
+
1023
+ # List all ad units in the specified ad client for this AdSense account.
1024
+ # @param [String] ad_client_id
1025
+ # Ad client for which to list ad units.
1026
+ # @param [Boolean] include_inactive
1027
+ # Whether to include inactive ad units. Default: true.
1028
+ # @param [Fixnum] max_results
1029
+ # The maximum number of ad units to include in the response, used for paging.
1030
+ # @param [String] page_token
1031
+ # A continuation token, used to page through ad units. To retrieve the next page,
1032
+ # set this parameter to the value of "nextPageToken" from the previous response.
1033
+ # @param [String] fields
1034
+ # Selector specifying which fields to include in a partial response.
1035
+ # @param [String] quota_user
1036
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1037
+ # characters.
1038
+ # @param [String] user_ip
1039
+ # Deprecated. Please use quotaUser instead.
1040
+ # @param [Google::Apis::RequestOptions] options
1041
+ # Request-specific options
1042
+ #
1043
+ # @yield [result, err] Result & error if block supplied
1044
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnits] parsed result object
1045
+ # @yieldparam err [StandardError] error object if request failed
1046
+ #
1047
+ # @return [Google::Apis::AdsenseV1_4::AdUnits]
1048
+ #
1049
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1050
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1051
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1052
+ def list_ad_units(ad_client_id, include_inactive: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1053
+ command = make_simple_command(:get, 'adclients/{adClientId}/adunits', options)
1054
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnits::Representation
1055
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnits
1056
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1057
+ command.query['includeInactive'] = include_inactive unless include_inactive.nil?
1058
+ command.query['maxResults'] = max_results unless max_results.nil?
1059
+ command.query['pageToken'] = page_token unless page_token.nil?
1060
+ command.query['fields'] = fields unless fields.nil?
1061
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1062
+ command.query['userIp'] = user_ip unless user_ip.nil?
1063
+ execute_or_queue_command(command, &block)
1064
+ end
1065
+
1066
+ # List all custom channels which the specified ad unit belongs to.
1067
+ # @param [String] ad_client_id
1068
+ # Ad client which contains the ad unit.
1069
+ # @param [String] ad_unit_id
1070
+ # Ad unit for which to list custom channels.
1071
+ # @param [Fixnum] max_results
1072
+ # The maximum number of custom channels to include in the response, used for
1073
+ # paging.
1074
+ # @param [String] page_token
1075
+ # A continuation token, used to page through custom channels. To retrieve the
1076
+ # next page, set this parameter to the value of "nextPageToken" from the
1077
+ # previous response.
1078
+ # @param [String] fields
1079
+ # Selector specifying which fields to include in a partial response.
1080
+ # @param [String] quota_user
1081
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1082
+ # characters.
1083
+ # @param [String] user_ip
1084
+ # Deprecated. Please use quotaUser instead.
1085
+ # @param [Google::Apis::RequestOptions] options
1086
+ # Request-specific options
1087
+ #
1088
+ # @yield [result, err] Result & error if block supplied
1089
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannels] parsed result object
1090
+ # @yieldparam err [StandardError] error object if request failed
1091
+ #
1092
+ # @return [Google::Apis::AdsenseV1_4::CustomChannels]
1093
+ #
1094
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1095
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1096
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1097
+ def list_ad_unit_custom_channels(ad_client_id, ad_unit_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1098
+ command = make_simple_command(:get, 'adclients/{adClientId}/adunits/{adUnitId}/customchannels', options)
1099
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannels::Representation
1100
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannels
1101
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1102
+ command.params['adUnitId'] = ad_unit_id unless ad_unit_id.nil?
1103
+ command.query['maxResults'] = max_results unless max_results.nil?
1104
+ command.query['pageToken'] = page_token unless page_token.nil?
1105
+ command.query['fields'] = fields unless fields.nil?
1106
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1107
+ command.query['userIp'] = user_ip unless user_ip.nil?
1108
+ execute_or_queue_command(command, &block)
1109
+ end
1110
+
1111
+ # Dismiss (delete) the specified alert from the publisher's AdSense account.
1112
+ # @param [String] alert_id
1113
+ # Alert to delete.
1114
+ # @param [String] fields
1115
+ # Selector specifying which fields to include in a partial response.
1116
+ # @param [String] quota_user
1117
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1118
+ # characters.
1119
+ # @param [String] user_ip
1120
+ # Deprecated. Please use quotaUser instead.
1121
+ # @param [Google::Apis::RequestOptions] options
1122
+ # Request-specific options
1123
+ #
1124
+ # @yield [result, err] Result & error if block supplied
1125
+ # @yieldparam result [NilClass] No result returned for this method
1126
+ # @yieldparam err [StandardError] error object if request failed
1127
+ #
1128
+ # @return [void]
1129
+ #
1130
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1131
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1132
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1133
+ def delete_alert(alert_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1134
+ command = make_simple_command(:delete, 'alerts/{alertId}', options)
1135
+ command.params['alertId'] = alert_id unless alert_id.nil?
1136
+ command.query['fields'] = fields unless fields.nil?
1137
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1138
+ command.query['userIp'] = user_ip unless user_ip.nil?
1139
+ execute_or_queue_command(command, &block)
1140
+ end
1141
+
1142
+ # List the alerts for this AdSense account.
1143
+ # @param [String] locale
1144
+ # The locale to use for translating alert messages. The account locale will be
1145
+ # used if this is not supplied. The AdSense default (English) will be used if
1146
+ # the supplied locale is invalid or unsupported.
1147
+ # @param [String] fields
1148
+ # Selector specifying which fields to include in a partial response.
1149
+ # @param [String] quota_user
1150
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1151
+ # characters.
1152
+ # @param [String] user_ip
1153
+ # Deprecated. Please use quotaUser instead.
1154
+ # @param [Google::Apis::RequestOptions] options
1155
+ # Request-specific options
1156
+ #
1157
+ # @yield [result, err] Result & error if block supplied
1158
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Alerts] parsed result object
1159
+ # @yieldparam err [StandardError] error object if request failed
1160
+ #
1161
+ # @return [Google::Apis::AdsenseV1_4::Alerts]
1162
+ #
1163
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1164
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1165
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1166
+ def list_alerts(locale: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1167
+ command = make_simple_command(:get, 'alerts', options)
1168
+ command.response_representation = Google::Apis::AdsenseV1_4::Alerts::Representation
1169
+ command.response_class = Google::Apis::AdsenseV1_4::Alerts
1170
+ command.query['locale'] = locale unless locale.nil?
1171
+ command.query['fields'] = fields unless fields.nil?
1172
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1173
+ command.query['userIp'] = user_ip unless user_ip.nil?
1174
+ execute_or_queue_command(command, &block)
1175
+ end
1176
+
1177
+ # Get the specified custom channel from the specified ad client.
1178
+ # @param [String] ad_client_id
1179
+ # Ad client which contains the custom channel.
1180
+ # @param [String] custom_channel_id
1181
+ # Custom channel to retrieve.
1182
+ # @param [String] fields
1183
+ # Selector specifying which fields to include in a partial response.
1184
+ # @param [String] quota_user
1185
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1186
+ # characters.
1187
+ # @param [String] user_ip
1188
+ # Deprecated. Please use quotaUser instead.
1189
+ # @param [Google::Apis::RequestOptions] options
1190
+ # Request-specific options
1191
+ #
1192
+ # @yield [result, err] Result & error if block supplied
1193
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannel] parsed result object
1194
+ # @yieldparam err [StandardError] error object if request failed
1195
+ #
1196
+ # @return [Google::Apis::AdsenseV1_4::CustomChannel]
1197
+ #
1198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1201
+ def get_custom_channel(ad_client_id, custom_channel_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1202
+ command = make_simple_command(:get, 'adclients/{adClientId}/customchannels/{customChannelId}', options)
1203
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannel::Representation
1204
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannel
1205
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1206
+ command.params['customChannelId'] = custom_channel_id unless custom_channel_id.nil?
1207
+ command.query['fields'] = fields unless fields.nil?
1208
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1209
+ command.query['userIp'] = user_ip unless user_ip.nil?
1210
+ execute_or_queue_command(command, &block)
1211
+ end
1212
+
1213
+ # List all custom channels in the specified ad client for this AdSense account.
1214
+ # @param [String] ad_client_id
1215
+ # Ad client for which to list custom channels.
1216
+ # @param [Fixnum] max_results
1217
+ # The maximum number of custom channels to include in the response, used for
1218
+ # paging.
1219
+ # @param [String] page_token
1220
+ # A continuation token, used to page through custom channels. To retrieve the
1221
+ # next page, set this parameter to the value of "nextPageToken" from the
1222
+ # previous response.
1223
+ # @param [String] fields
1224
+ # Selector specifying which fields to include in a partial response.
1225
+ # @param [String] quota_user
1226
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1227
+ # characters.
1228
+ # @param [String] user_ip
1229
+ # Deprecated. Please use quotaUser instead.
1230
+ # @param [Google::Apis::RequestOptions] options
1231
+ # Request-specific options
1232
+ #
1233
+ # @yield [result, err] Result & error if block supplied
1234
+ # @yieldparam result [Google::Apis::AdsenseV1_4::CustomChannels] parsed result object
1235
+ # @yieldparam err [StandardError] error object if request failed
1236
+ #
1237
+ # @return [Google::Apis::AdsenseV1_4::CustomChannels]
1238
+ #
1239
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1240
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1241
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1242
+ def list_custom_channels(ad_client_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1243
+ command = make_simple_command(:get, 'adclients/{adClientId}/customchannels', options)
1244
+ command.response_representation = Google::Apis::AdsenseV1_4::CustomChannels::Representation
1245
+ command.response_class = Google::Apis::AdsenseV1_4::CustomChannels
1246
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1247
+ command.query['maxResults'] = max_results unless max_results.nil?
1248
+ command.query['pageToken'] = page_token unless page_token.nil?
1249
+ command.query['fields'] = fields unless fields.nil?
1250
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1251
+ command.query['userIp'] = user_ip unless user_ip.nil?
1252
+ execute_or_queue_command(command, &block)
1253
+ end
1254
+
1255
+ # List all ad units in the specified custom channel.
1256
+ # @param [String] ad_client_id
1257
+ # Ad client which contains the custom channel.
1258
+ # @param [String] custom_channel_id
1259
+ # Custom channel for which to list ad units.
1260
+ # @param [Boolean] include_inactive
1261
+ # Whether to include inactive ad units. Default: true.
1262
+ # @param [Fixnum] max_results
1263
+ # The maximum number of ad units to include in the response, used for paging.
1264
+ # @param [String] page_token
1265
+ # A continuation token, used to page through ad units. To retrieve the next page,
1266
+ # set this parameter to the value of "nextPageToken" from the previous response.
1267
+ # @param [String] fields
1268
+ # Selector specifying which fields to include in a partial response.
1269
+ # @param [String] quota_user
1270
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1271
+ # characters.
1272
+ # @param [String] user_ip
1273
+ # Deprecated. Please use quotaUser instead.
1274
+ # @param [Google::Apis::RequestOptions] options
1275
+ # Request-specific options
1276
+ #
1277
+ # @yield [result, err] Result & error if block supplied
1278
+ # @yieldparam result [Google::Apis::AdsenseV1_4::AdUnits] parsed result object
1279
+ # @yieldparam err [StandardError] error object if request failed
1280
+ #
1281
+ # @return [Google::Apis::AdsenseV1_4::AdUnits]
1282
+ #
1283
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1284
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1285
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1286
+ def list_custom_channel_ad_units(ad_client_id, custom_channel_id, include_inactive: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1287
+ command = make_simple_command(:get, 'adclients/{adClientId}/customchannels/{customChannelId}/adunits', options)
1288
+ command.response_representation = Google::Apis::AdsenseV1_4::AdUnits::Representation
1289
+ command.response_class = Google::Apis::AdsenseV1_4::AdUnits
1290
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1291
+ command.params['customChannelId'] = custom_channel_id unless custom_channel_id.nil?
1292
+ command.query['includeInactive'] = include_inactive unless include_inactive.nil?
1293
+ command.query['maxResults'] = max_results unless max_results.nil?
1294
+ command.query['pageToken'] = page_token unless page_token.nil?
1295
+ command.query['fields'] = fields unless fields.nil?
1296
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1297
+ command.query['userIp'] = user_ip unless user_ip.nil?
1298
+ execute_or_queue_command(command, &block)
1299
+ end
1300
+
1301
+ # List the metadata for the dimensions available to this AdSense account.
1302
+ # @param [String] fields
1303
+ # Selector specifying which fields to include in a partial response.
1304
+ # @param [String] quota_user
1305
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1306
+ # characters.
1307
+ # @param [String] user_ip
1308
+ # Deprecated. Please use quotaUser instead.
1309
+ # @param [Google::Apis::RequestOptions] options
1310
+ # Request-specific options
1311
+ #
1312
+ # @yield [result, err] Result & error if block supplied
1313
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Metadata] parsed result object
1314
+ # @yieldparam err [StandardError] error object if request failed
1315
+ #
1316
+ # @return [Google::Apis::AdsenseV1_4::Metadata]
1317
+ #
1318
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1319
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1320
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1321
+ def list_metadata_dimensions(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1322
+ command = make_simple_command(:get, 'metadata/dimensions', options)
1323
+ command.response_representation = Google::Apis::AdsenseV1_4::Metadata::Representation
1324
+ command.response_class = Google::Apis::AdsenseV1_4::Metadata
1325
+ command.query['fields'] = fields unless fields.nil?
1326
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1327
+ command.query['userIp'] = user_ip unless user_ip.nil?
1328
+ execute_or_queue_command(command, &block)
1329
+ end
1330
+
1331
+ # List the metadata for the metrics available to this AdSense account.
1332
+ # @param [String] fields
1333
+ # Selector specifying which fields to include in a partial response.
1334
+ # @param [String] quota_user
1335
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1336
+ # characters.
1337
+ # @param [String] user_ip
1338
+ # Deprecated. Please use quotaUser instead.
1339
+ # @param [Google::Apis::RequestOptions] options
1340
+ # Request-specific options
1341
+ #
1342
+ # @yield [result, err] Result & error if block supplied
1343
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Metadata] parsed result object
1344
+ # @yieldparam err [StandardError] error object if request failed
1345
+ #
1346
+ # @return [Google::Apis::AdsenseV1_4::Metadata]
1347
+ #
1348
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1349
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1350
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1351
+ def list_metadata_metrics(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1352
+ command = make_simple_command(:get, 'metadata/metrics', options)
1353
+ command.response_representation = Google::Apis::AdsenseV1_4::Metadata::Representation
1354
+ command.response_class = Google::Apis::AdsenseV1_4::Metadata
1355
+ command.query['fields'] = fields unless fields.nil?
1356
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1357
+ command.query['userIp'] = user_ip unless user_ip.nil?
1358
+ execute_or_queue_command(command, &block)
1359
+ end
1360
+
1361
+ # List the payments for this AdSense account.
1362
+ # @param [String] fields
1363
+ # Selector specifying which fields to include in a partial response.
1364
+ # @param [String] quota_user
1365
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1366
+ # characters.
1367
+ # @param [String] user_ip
1368
+ # Deprecated. Please use quotaUser instead.
1369
+ # @param [Google::Apis::RequestOptions] options
1370
+ # Request-specific options
1371
+ #
1372
+ # @yield [result, err] Result & error if block supplied
1373
+ # @yieldparam result [Google::Apis::AdsenseV1_4::Payments] parsed result object
1374
+ # @yieldparam err [StandardError] error object if request failed
1375
+ #
1376
+ # @return [Google::Apis::AdsenseV1_4::Payments]
1377
+ #
1378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1381
+ def list_payments(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1382
+ command = make_simple_command(:get, 'payments', options)
1383
+ command.response_representation = Google::Apis::AdsenseV1_4::Payments::Representation
1384
+ command.response_class = Google::Apis::AdsenseV1_4::Payments
1385
+ command.query['fields'] = fields unless fields.nil?
1386
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1387
+ command.query['userIp'] = user_ip unless user_ip.nil?
1388
+ execute_or_queue_command(command, &block)
1389
+ end
1390
+
1391
+ # Generate an AdSense report based on the report request sent in the query
1392
+ # parameters. Returns the result as JSON; to retrieve output in CSV format
1393
+ # specify "alt=csv" as a query parameter.
1394
+ # @param [String] start_date
1395
+ # Start of the date range to report on in "YYYY-MM-DD" format, inclusive.
1396
+ # @param [String] end_date
1397
+ # End of the date range to report on in "YYYY-MM-DD" format, inclusive.
1398
+ # @param [Array<String>, String] account_id
1399
+ # Accounts upon which to report.
1400
+ # @param [String] currency
1401
+ # Optional currency to use when reporting on monetary metrics. Defaults to the
1402
+ # account's currency if not set.
1403
+ # @param [Array<String>, String] dimension
1404
+ # Dimensions to base the report on.
1405
+ # @param [Array<String>, String] filter
1406
+ # Filters to be run on the report.
1407
+ # @param [String] locale
1408
+ # Optional locale to use for translating report output to a local language.
1409
+ # Defaults to "en_US" if not specified.
1410
+ # @param [Fixnum] max_results
1411
+ # The maximum number of rows of report data to return.
1412
+ # @param [Array<String>, String] metric
1413
+ # Numeric columns to include in the report.
1414
+ # @param [Array<String>, String] sort
1415
+ # The name of a dimension or metric to sort the resulting report on, optionally
1416
+ # prefixed with "+" to sort ascending or "-" to sort descending. If no prefix is
1417
+ # specified, the column is sorted ascending.
1418
+ # @param [Fixnum] start_index
1419
+ # Index of the first row of report data to return.
1420
+ # @param [Boolean] use_timezone_reporting
1421
+ # Whether the report should be generated in the AdSense account's local timezone.
1422
+ # If false default PST/PDT timezone will be used.
1423
+ # @param [String] fields
1424
+ # Selector specifying which fields to include in a partial response.
1425
+ # @param [String] quota_user
1426
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1427
+ # characters.
1428
+ # @param [String] user_ip
1429
+ # Deprecated. Please use quotaUser instead.
1430
+ # @param [IO, String] download_dest
1431
+ # IO stream or filename to receive content download
1432
+ # @param [Google::Apis::RequestOptions] options
1433
+ # Request-specific options
1434
+ #
1435
+ # @yield [result, err] Result & error if block supplied
1436
+ # @yieldparam result [Google::Apis::AdsenseV1_4::GenerateReportResponse] parsed result object
1437
+ # @yieldparam err [StandardError] error object if request failed
1438
+ #
1439
+ # @return [Google::Apis::AdsenseV1_4::GenerateReportResponse]
1440
+ #
1441
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1442
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1443
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1444
+ def generate_report(start_date, end_date, account_id: nil, currency: nil, dimension: nil, filter: nil, locale: nil, max_results: nil, metric: nil, sort: nil, start_index: nil, use_timezone_reporting: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
1445
+ if download_dest.nil?
1446
+ command = make_simple_command(:get, 'reports', options)
1447
+ else
1448
+ command = make_download_command(:get, 'reports', options)
1449
+ command.download_dest = download_dest
1450
+ end
1451
+ command.response_representation = Google::Apis::AdsenseV1_4::GenerateReportResponse::Representation
1452
+ command.response_class = Google::Apis::AdsenseV1_4::GenerateReportResponse
1453
+ command.query['accountId'] = account_id unless account_id.nil?
1454
+ command.query['currency'] = currency unless currency.nil?
1455
+ command.query['dimension'] = dimension unless dimension.nil?
1456
+ command.query['endDate'] = end_date unless end_date.nil?
1457
+ command.query['filter'] = filter unless filter.nil?
1458
+ command.query['locale'] = locale unless locale.nil?
1459
+ command.query['maxResults'] = max_results unless max_results.nil?
1460
+ command.query['metric'] = metric unless metric.nil?
1461
+ command.query['sort'] = sort unless sort.nil?
1462
+ command.query['startDate'] = start_date unless start_date.nil?
1463
+ command.query['startIndex'] = start_index unless start_index.nil?
1464
+ command.query['useTimezoneReporting'] = use_timezone_reporting unless use_timezone_reporting.nil?
1465
+ command.query['fields'] = fields unless fields.nil?
1466
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1467
+ command.query['userIp'] = user_ip unless user_ip.nil?
1468
+ execute_or_queue_command(command, &block)
1469
+ end
1470
+
1471
+ # Generate an AdSense report based on the saved report ID sent in the query
1472
+ # parameters.
1473
+ # @param [String] saved_report_id
1474
+ # The saved report to retrieve.
1475
+ # @param [String] locale
1476
+ # Optional locale to use for translating report output to a local language.
1477
+ # Defaults to "en_US" if not specified.
1478
+ # @param [Fixnum] max_results
1479
+ # The maximum number of rows of report data to return.
1480
+ # @param [Fixnum] start_index
1481
+ # Index of the first row of report data to return.
1482
+ # @param [String] fields
1483
+ # Selector specifying which fields to include in a partial response.
1484
+ # @param [String] quota_user
1485
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1486
+ # characters.
1487
+ # @param [String] user_ip
1488
+ # Deprecated. Please use quotaUser instead.
1489
+ # @param [Google::Apis::RequestOptions] options
1490
+ # Request-specific options
1491
+ #
1492
+ # @yield [result, err] Result & error if block supplied
1493
+ # @yieldparam result [Google::Apis::AdsenseV1_4::GenerateReportResponse] parsed result object
1494
+ # @yieldparam err [StandardError] error object if request failed
1495
+ #
1496
+ # @return [Google::Apis::AdsenseV1_4::GenerateReportResponse]
1497
+ #
1498
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1499
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1500
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1501
+ def generate_saved_report(saved_report_id, locale: nil, max_results: nil, start_index: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1502
+ command = make_simple_command(:get, 'reports/{savedReportId}', options)
1503
+ command.response_representation = Google::Apis::AdsenseV1_4::GenerateReportResponse::Representation
1504
+ command.response_class = Google::Apis::AdsenseV1_4::GenerateReportResponse
1505
+ command.params['savedReportId'] = saved_report_id unless saved_report_id.nil?
1506
+ command.query['locale'] = locale unless locale.nil?
1507
+ command.query['maxResults'] = max_results unless max_results.nil?
1508
+ command.query['startIndex'] = start_index unless start_index.nil?
1509
+ command.query['fields'] = fields unless fields.nil?
1510
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1511
+ command.query['userIp'] = user_ip unless user_ip.nil?
1512
+ execute_or_queue_command(command, &block)
1513
+ end
1514
+
1515
+ # List all saved reports in this AdSense account.
1516
+ # @param [Fixnum] max_results
1517
+ # The maximum number of saved reports to include in the response, used for
1518
+ # paging.
1519
+ # @param [String] page_token
1520
+ # A continuation token, used to page through saved reports. To retrieve the next
1521
+ # page, set this parameter to the value of "nextPageToken" from the previous
1522
+ # response.
1523
+ # @param [String] fields
1524
+ # Selector specifying which fields to include in a partial response.
1525
+ # @param [String] quota_user
1526
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1527
+ # characters.
1528
+ # @param [String] user_ip
1529
+ # Deprecated. Please use quotaUser instead.
1530
+ # @param [Google::Apis::RequestOptions] options
1531
+ # Request-specific options
1532
+ #
1533
+ # @yield [result, err] Result & error if block supplied
1534
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedReports] parsed result object
1535
+ # @yieldparam err [StandardError] error object if request failed
1536
+ #
1537
+ # @return [Google::Apis::AdsenseV1_4::SavedReports]
1538
+ #
1539
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1540
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1541
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1542
+ def list_saved_reports(max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1543
+ command = make_simple_command(:get, 'reports/saved', options)
1544
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedReports::Representation
1545
+ command.response_class = Google::Apis::AdsenseV1_4::SavedReports
1546
+ command.query['maxResults'] = max_results unless max_results.nil?
1547
+ command.query['pageToken'] = page_token unless page_token.nil?
1548
+ command.query['fields'] = fields unless fields.nil?
1549
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1550
+ command.query['userIp'] = user_ip unless user_ip.nil?
1551
+ execute_or_queue_command(command, &block)
1552
+ end
1553
+
1554
+ # Get a specific saved ad style from the user's account.
1555
+ # @param [String] saved_ad_style_id
1556
+ # Saved ad style to retrieve.
1557
+ # @param [String] fields
1558
+ # Selector specifying which fields to include in a partial response.
1559
+ # @param [String] quota_user
1560
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1561
+ # characters.
1562
+ # @param [String] user_ip
1563
+ # Deprecated. Please use quotaUser instead.
1564
+ # @param [Google::Apis::RequestOptions] options
1565
+ # Request-specific options
1566
+ #
1567
+ # @yield [result, err] Result & error if block supplied
1568
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedAdStyle] parsed result object
1569
+ # @yieldparam err [StandardError] error object if request failed
1570
+ #
1571
+ # @return [Google::Apis::AdsenseV1_4::SavedAdStyle]
1572
+ #
1573
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1574
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1575
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1576
+ def get_saved_ad_style(saved_ad_style_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1577
+ command = make_simple_command(:get, 'savedadstyles/{savedAdStyleId}', options)
1578
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedAdStyle::Representation
1579
+ command.response_class = Google::Apis::AdsenseV1_4::SavedAdStyle
1580
+ command.params['savedAdStyleId'] = saved_ad_style_id unless saved_ad_style_id.nil?
1581
+ command.query['fields'] = fields unless fields.nil?
1582
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1583
+ command.query['userIp'] = user_ip unless user_ip.nil?
1584
+ execute_or_queue_command(command, &block)
1585
+ end
1586
+
1587
+ # List all saved ad styles in the user's account.
1588
+ # @param [Fixnum] max_results
1589
+ # The maximum number of saved ad styles to include in the response, used for
1590
+ # paging.
1591
+ # @param [String] page_token
1592
+ # A continuation token, used to page through saved ad styles. To retrieve the
1593
+ # next page, set this parameter to the value of "nextPageToken" from the
1594
+ # previous response.
1595
+ # @param [String] fields
1596
+ # Selector specifying which fields to include in a partial response.
1597
+ # @param [String] quota_user
1598
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1599
+ # characters.
1600
+ # @param [String] user_ip
1601
+ # Deprecated. Please use quotaUser instead.
1602
+ # @param [Google::Apis::RequestOptions] options
1603
+ # Request-specific options
1604
+ #
1605
+ # @yield [result, err] Result & error if block supplied
1606
+ # @yieldparam result [Google::Apis::AdsenseV1_4::SavedAdStyles] parsed result object
1607
+ # @yieldparam err [StandardError] error object if request failed
1608
+ #
1609
+ # @return [Google::Apis::AdsenseV1_4::SavedAdStyles]
1610
+ #
1611
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1612
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1613
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1614
+ def list_saved_ad_styles(max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1615
+ command = make_simple_command(:get, 'savedadstyles', options)
1616
+ command.response_representation = Google::Apis::AdsenseV1_4::SavedAdStyles::Representation
1617
+ command.response_class = Google::Apis::AdsenseV1_4::SavedAdStyles
1618
+ command.query['maxResults'] = max_results unless max_results.nil?
1619
+ command.query['pageToken'] = page_token unless page_token.nil?
1620
+ command.query['fields'] = fields unless fields.nil?
1621
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1622
+ command.query['userIp'] = user_ip unless user_ip.nil?
1623
+ execute_or_queue_command(command, &block)
1624
+ end
1625
+
1626
+ # List all URL channels in the specified ad client for this AdSense account.
1627
+ # @param [String] ad_client_id
1628
+ # Ad client for which to list URL channels.
1629
+ # @param [Fixnum] max_results
1630
+ # The maximum number of URL channels to include in the response, used for paging.
1631
+ # @param [String] page_token
1632
+ # A continuation token, used to page through URL channels. To retrieve the next
1633
+ # page, set this parameter to the value of "nextPageToken" from the previous
1634
+ # response.
1635
+ # @param [String] fields
1636
+ # Selector specifying which fields to include in a partial response.
1637
+ # @param [String] quota_user
1638
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
1639
+ # characters.
1640
+ # @param [String] user_ip
1641
+ # Deprecated. Please use quotaUser instead.
1642
+ # @param [Google::Apis::RequestOptions] options
1643
+ # Request-specific options
1644
+ #
1645
+ # @yield [result, err] Result & error if block supplied
1646
+ # @yieldparam result [Google::Apis::AdsenseV1_4::UrlChannels] parsed result object
1647
+ # @yieldparam err [StandardError] error object if request failed
1648
+ #
1649
+ # @return [Google::Apis::AdsenseV1_4::UrlChannels]
1650
+ #
1651
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1652
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1653
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1654
+ def list_url_channels(ad_client_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
1655
+ command = make_simple_command(:get, 'adclients/{adClientId}/urlchannels', options)
1656
+ command.response_representation = Google::Apis::AdsenseV1_4::UrlChannels::Representation
1657
+ command.response_class = Google::Apis::AdsenseV1_4::UrlChannels
1658
+ command.params['adClientId'] = ad_client_id unless ad_client_id.nil?
1659
+ command.query['maxResults'] = max_results unless max_results.nil?
1660
+ command.query['pageToken'] = page_token unless page_token.nil?
1661
+ command.query['fields'] = fields unless fields.nil?
1662
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1663
+ command.query['userIp'] = user_ip unless user_ip.nil?
1664
+ execute_or_queue_command(command, &block)
1665
+ end
1666
+
1667
+ protected
1668
+
1669
+ def apply_command_defaults(command)
1670
+ command.query['key'] = key unless key.nil?
1671
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1672
+ command.query['userIp'] = user_ip unless user_ip.nil?
1673
+ end
1674
+ end
1675
+ end
1676
+ end
1677
+ end