google-apis-adexchangebuyer2_v2beta1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,2638 @@
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 Adexchangebuyer2V2beta1
23
+ # Ad Exchange Buyer API II
24
+ #
25
+ # Accesses the latest features for managing Authorized Buyers accounts, Real-
26
+ # Time Bidding configurations and auction metrics, and Marketplace programmatic
27
+ # deals.
28
+ #
29
+ # @example
30
+ # require 'google/apis/adexchangebuyer2_v2beta1'
31
+ #
32
+ # Adexchangebuyer2 = Google::Apis::Adexchangebuyer2V2beta1 # Alias the module
33
+ # service = Adexchangebuyer2::AdExchangeBuyerIIService.new
34
+ #
35
+ # @see https://developers.google.com/authorized-buyers/apis/reference/rest/
36
+ class AdExchangeBuyerIIService < Google::Apis::Core::BaseService
37
+ # @return [String]
38
+ # API key. Your API key identifies your project and provides you with API access,
39
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
40
+ attr_accessor :key
41
+
42
+ # @return [String]
43
+ # Available to use for quota purposes for server-side applications. Can be any
44
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
45
+ attr_accessor :quota_user
46
+
47
+ def initialize
48
+ super('https://adexchangebuyer.googleapis.com/', '',
49
+ client_name: 'google-apis-adexchangebuyer2_v2beta1',
50
+ client_version: Google::Apis::Adexchangebuyer2V2beta1::GEM_VERSION)
51
+ @batch_path = 'batch'
52
+ end
53
+
54
+ # Creates a new client buyer.
55
+ # @param [Fixnum] account_id
56
+ # Unique numerical account ID for the buyer of which the client buyer is a
57
+ # customer; the sponsor buyer to create a client for. (required)
58
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Client] client_object
59
+ # @param [String] fields
60
+ # Selector specifying which fields to include in a partial response.
61
+ # @param [String] quota_user
62
+ # Available to use for quota purposes for server-side applications. Can be any
63
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
64
+ # @param [Google::Apis::RequestOptions] options
65
+ # Request-specific options
66
+ #
67
+ # @yield [result, err] Result & error if block supplied
68
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Client] parsed result object
69
+ # @yieldparam err [StandardError] error object if request failed
70
+ #
71
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Client]
72
+ #
73
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
74
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
75
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
76
+ def create_account_client(account_id, client_object = nil, fields: nil, quota_user: nil, options: nil, &block)
77
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/clients', options)
78
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Client::Representation
79
+ command.request_object = client_object
80
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Client::Representation
81
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Client
82
+ command.params['accountId'] = account_id unless account_id.nil?
83
+ command.query['fields'] = fields unless fields.nil?
84
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
85
+ execute_or_queue_command(command, &block)
86
+ end
87
+
88
+ # Gets a client buyer with a given client account ID.
89
+ # @param [Fixnum] account_id
90
+ # Numerical account ID of the client's sponsor buyer. (required)
91
+ # @param [Fixnum] client_account_id
92
+ # Numerical account ID of the client buyer to retrieve. (required)
93
+ # @param [String] fields
94
+ # Selector specifying which fields to include in a partial response.
95
+ # @param [String] quota_user
96
+ # Available to use for quota purposes for server-side applications. Can be any
97
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
98
+ # @param [Google::Apis::RequestOptions] options
99
+ # Request-specific options
100
+ #
101
+ # @yield [result, err] Result & error if block supplied
102
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Client] parsed result object
103
+ # @yieldparam err [StandardError] error object if request failed
104
+ #
105
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Client]
106
+ #
107
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
108
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
109
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
110
+ def get_account_client(account_id, client_account_id, fields: nil, quota_user: nil, options: nil, &block)
111
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}', options)
112
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Client::Representation
113
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Client
114
+ command.params['accountId'] = account_id unless account_id.nil?
115
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
116
+ command.query['fields'] = fields unless fields.nil?
117
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
118
+ execute_or_queue_command(command, &block)
119
+ end
120
+
121
+ # Lists all the clients for the current sponsor buyer.
122
+ # @param [Fixnum] account_id
123
+ # Unique numerical account ID of the sponsor buyer to list the clients for.
124
+ # @param [Fixnum] page_size
125
+ # Requested page size. The server may return fewer clients than requested. If
126
+ # unspecified, the server will pick an appropriate default.
127
+ # @param [String] page_token
128
+ # A token identifying a page of results the server should return. Typically,
129
+ # this is the value of ListClientsResponse.nextPageToken returned from the
130
+ # previous call to the accounts.clients.list method.
131
+ # @param [String] partner_client_id
132
+ # Optional unique identifier (from the standpoint of an Ad Exchange sponsor
133
+ # buyer partner) of the client to return. If specified, at most one client will
134
+ # be returned in the response.
135
+ # @param [String] fields
136
+ # Selector specifying which fields to include in a partial response.
137
+ # @param [String] quota_user
138
+ # Available to use for quota purposes for server-side applications. Can be any
139
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
140
+ # @param [Google::Apis::RequestOptions] options
141
+ # Request-specific options
142
+ #
143
+ # @yield [result, err] Result & error if block supplied
144
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListClientsResponse] parsed result object
145
+ # @yieldparam err [StandardError] error object if request failed
146
+ #
147
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListClientsResponse]
148
+ #
149
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
150
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
151
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
152
+ def list_account_clients(account_id, page_size: nil, page_token: nil, partner_client_id: nil, fields: nil, quota_user: nil, options: nil, &block)
153
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients', options)
154
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListClientsResponse::Representation
155
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListClientsResponse
156
+ command.params['accountId'] = account_id unless account_id.nil?
157
+ command.query['pageSize'] = page_size unless page_size.nil?
158
+ command.query['pageToken'] = page_token unless page_token.nil?
159
+ command.query['partnerClientId'] = partner_client_id unless partner_client_id.nil?
160
+ command.query['fields'] = fields unless fields.nil?
161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
162
+ execute_or_queue_command(command, &block)
163
+ end
164
+
165
+ # Updates an existing client buyer.
166
+ # @param [Fixnum] account_id
167
+ # Unique numerical account ID for the buyer of which the client buyer is a
168
+ # customer; the sponsor buyer to update a client for. (required)
169
+ # @param [Fixnum] client_account_id
170
+ # Unique numerical account ID of the client to update. (required)
171
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Client] client_object
172
+ # @param [String] fields
173
+ # Selector specifying which fields to include in a partial response.
174
+ # @param [String] quota_user
175
+ # Available to use for quota purposes for server-side applications. Can be any
176
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
177
+ # @param [Google::Apis::RequestOptions] options
178
+ # Request-specific options
179
+ #
180
+ # @yield [result, err] Result & error if block supplied
181
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Client] parsed result object
182
+ # @yieldparam err [StandardError] error object if request failed
183
+ #
184
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Client]
185
+ #
186
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
187
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
188
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
189
+ def update_account_client(account_id, client_account_id, client_object = nil, fields: nil, quota_user: nil, options: nil, &block)
190
+ command = make_simple_command(:put, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}', options)
191
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Client::Representation
192
+ command.request_object = client_object
193
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Client::Representation
194
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Client
195
+ command.params['accountId'] = account_id unless account_id.nil?
196
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
197
+ command.query['fields'] = fields unless fields.nil?
198
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
199
+ execute_or_queue_command(command, &block)
200
+ end
201
+
202
+ # Creates and sends out an email invitation to access an Ad Exchange client
203
+ # buyer account.
204
+ # @param [Fixnum] account_id
205
+ # Numerical account ID of the client's sponsor buyer. (required)
206
+ # @param [Fixnum] client_account_id
207
+ # Numerical account ID of the client buyer that the user should be associated
208
+ # with. (required)
209
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation] client_user_invitation_object
210
+ # @param [String] fields
211
+ # Selector specifying which fields to include in a partial response.
212
+ # @param [String] quota_user
213
+ # Available to use for quota purposes for server-side applications. Can be any
214
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
215
+ # @param [Google::Apis::RequestOptions] options
216
+ # Request-specific options
217
+ #
218
+ # @yield [result, err] Result & error if block supplied
219
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation] parsed result object
220
+ # @yieldparam err [StandardError] error object if request failed
221
+ #
222
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation]
223
+ #
224
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
225
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
226
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
227
+ def create_account_client_invitation(account_id, client_account_id, client_user_invitation_object = nil, fields: nil, quota_user: nil, options: nil, &block)
228
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations', options)
229
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation::Representation
230
+ command.request_object = client_user_invitation_object
231
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation::Representation
232
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation
233
+ command.params['accountId'] = account_id unless account_id.nil?
234
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
235
+ command.query['fields'] = fields unless fields.nil?
236
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
237
+ execute_or_queue_command(command, &block)
238
+ end
239
+
240
+ # Retrieves an existing client user invitation.
241
+ # @param [Fixnum] account_id
242
+ # Numerical account ID of the client's sponsor buyer. (required)
243
+ # @param [Fixnum] client_account_id
244
+ # Numerical account ID of the client buyer that the user invitation to be
245
+ # retrieved is associated with. (required)
246
+ # @param [Fixnum] invitation_id
247
+ # Numerical identifier of the user invitation to retrieve. (required)
248
+ # @param [String] fields
249
+ # Selector specifying which fields to include in a partial response.
250
+ # @param [String] quota_user
251
+ # Available to use for quota purposes for server-side applications. Can be any
252
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
253
+ # @param [Google::Apis::RequestOptions] options
254
+ # Request-specific options
255
+ #
256
+ # @yield [result, err] Result & error if block supplied
257
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation] parsed result object
258
+ # @yieldparam err [StandardError] error object if request failed
259
+ #
260
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation]
261
+ #
262
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
263
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
264
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
265
+ def get_account_client_invitation(account_id, client_account_id, invitation_id, fields: nil, quota_user: nil, options: nil, &block)
266
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations/{invitationId}', options)
267
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation::Representation
268
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ClientUserInvitation
269
+ command.params['accountId'] = account_id unless account_id.nil?
270
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
271
+ command.params['invitationId'] = invitation_id unless invitation_id.nil?
272
+ command.query['fields'] = fields unless fields.nil?
273
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
274
+ execute_or_queue_command(command, &block)
275
+ end
276
+
277
+ # Lists all the client users invitations for a client with a given account ID.
278
+ # @param [Fixnum] account_id
279
+ # Numerical account ID of the client's sponsor buyer. (required)
280
+ # @param [String] client_account_id
281
+ # Numerical account ID of the client buyer to list invitations for. (required)
282
+ # You must either specify a string representation of a numerical account
283
+ # identifier or the `-` character to list all the invitations for all the
284
+ # clients of a given sponsor buyer.
285
+ # @param [Fixnum] page_size
286
+ # Requested page size. Server may return fewer clients than requested. If
287
+ # unspecified, server will pick an appropriate default.
288
+ # @param [String] page_token
289
+ # A token identifying a page of results the server should return. Typically,
290
+ # this is the value of ListClientUserInvitationsResponse.nextPageToken returned
291
+ # from the previous call to the clients.invitations.list method.
292
+ # @param [String] fields
293
+ # Selector specifying which fields to include in a partial response.
294
+ # @param [String] quota_user
295
+ # Available to use for quota purposes for server-side applications. Can be any
296
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
297
+ # @param [Google::Apis::RequestOptions] options
298
+ # Request-specific options
299
+ #
300
+ # @yield [result, err] Result & error if block supplied
301
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListClientUserInvitationsResponse] parsed result object
302
+ # @yieldparam err [StandardError] error object if request failed
303
+ #
304
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListClientUserInvitationsResponse]
305
+ #
306
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
307
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
308
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
309
+ def list_account_client_invitations(account_id, client_account_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
310
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations', options)
311
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListClientUserInvitationsResponse::Representation
312
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListClientUserInvitationsResponse
313
+ command.params['accountId'] = account_id unless account_id.nil?
314
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
315
+ command.query['pageSize'] = page_size unless page_size.nil?
316
+ command.query['pageToken'] = page_token unless page_token.nil?
317
+ command.query['fields'] = fields unless fields.nil?
318
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
319
+ execute_or_queue_command(command, &block)
320
+ end
321
+
322
+ # Retrieves an existing client user.
323
+ # @param [Fixnum] account_id
324
+ # Numerical account ID of the client's sponsor buyer. (required)
325
+ # @param [Fixnum] client_account_id
326
+ # Numerical account ID of the client buyer that the user to be retrieved is
327
+ # associated with. (required)
328
+ # @param [Fixnum] user_id
329
+ # Numerical identifier of the user to retrieve. (required)
330
+ # @param [String] fields
331
+ # Selector specifying which fields to include in a partial response.
332
+ # @param [String] quota_user
333
+ # Available to use for quota purposes for server-side applications. Can be any
334
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
335
+ # @param [Google::Apis::RequestOptions] options
336
+ # Request-specific options
337
+ #
338
+ # @yield [result, err] Result & error if block supplied
339
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ClientUser] parsed result object
340
+ # @yieldparam err [StandardError] error object if request failed
341
+ #
342
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ClientUser]
343
+ #
344
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
345
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
346
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
347
+ def get_account_client_user(account_id, client_account_id, user_id, fields: nil, quota_user: nil, options: nil, &block)
348
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}', options)
349
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUser::Representation
350
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ClientUser
351
+ command.params['accountId'] = account_id unless account_id.nil?
352
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
353
+ command.params['userId'] = user_id unless user_id.nil?
354
+ command.query['fields'] = fields unless fields.nil?
355
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
356
+ execute_or_queue_command(command, &block)
357
+ end
358
+
359
+ # Lists all the known client users for a specified sponsor buyer account ID.
360
+ # @param [Fixnum] account_id
361
+ # Numerical account ID of the sponsor buyer of the client to list users for. (
362
+ # required)
363
+ # @param [String] client_account_id
364
+ # The account ID of the client buyer to list users for. (required) You must
365
+ # specify either a string representation of a numerical account identifier or
366
+ # the `-` character to list all the client users for all the clients of a given
367
+ # sponsor buyer.
368
+ # @param [Fixnum] page_size
369
+ # Requested page size. The server may return fewer clients than requested. If
370
+ # unspecified, the server will pick an appropriate default.
371
+ # @param [String] page_token
372
+ # A token identifying a page of results the server should return. Typically,
373
+ # this is the value of ListClientUsersResponse.nextPageToken returned from the
374
+ # previous call to the accounts.clients.users.list method.
375
+ # @param [String] fields
376
+ # Selector specifying which fields to include in a partial response.
377
+ # @param [String] quota_user
378
+ # Available to use for quota purposes for server-side applications. Can be any
379
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
380
+ # @param [Google::Apis::RequestOptions] options
381
+ # Request-specific options
382
+ #
383
+ # @yield [result, err] Result & error if block supplied
384
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListClientUsersResponse] parsed result object
385
+ # @yieldparam err [StandardError] error object if request failed
386
+ #
387
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListClientUsersResponse]
388
+ #
389
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
390
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
391
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
392
+ def list_account_client_users(account_id, client_account_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
393
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/users', options)
394
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListClientUsersResponse::Representation
395
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListClientUsersResponse
396
+ command.params['accountId'] = account_id unless account_id.nil?
397
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
398
+ command.query['pageSize'] = page_size unless page_size.nil?
399
+ command.query['pageToken'] = page_token unless page_token.nil?
400
+ command.query['fields'] = fields unless fields.nil?
401
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
402
+ execute_or_queue_command(command, &block)
403
+ end
404
+
405
+ # Updates an existing client user. Only the user status can be changed on update.
406
+ # @param [Fixnum] account_id
407
+ # Numerical account ID of the client's sponsor buyer. (required)
408
+ # @param [Fixnum] client_account_id
409
+ # Numerical account ID of the client buyer that the user to be retrieved is
410
+ # associated with. (required)
411
+ # @param [Fixnum] user_id
412
+ # Numerical identifier of the user to retrieve. (required)
413
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::ClientUser] client_user_object
414
+ # @param [String] fields
415
+ # Selector specifying which fields to include in a partial response.
416
+ # @param [String] quota_user
417
+ # Available to use for quota purposes for server-side applications. Can be any
418
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
419
+ # @param [Google::Apis::RequestOptions] options
420
+ # Request-specific options
421
+ #
422
+ # @yield [result, err] Result & error if block supplied
423
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ClientUser] parsed result object
424
+ # @yieldparam err [StandardError] error object if request failed
425
+ #
426
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ClientUser]
427
+ #
428
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
429
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
430
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
431
+ def update_account_client_user(account_id, client_account_id, user_id, client_user_object = nil, fields: nil, quota_user: nil, options: nil, &block)
432
+ command = make_simple_command(:put, 'v2beta1/accounts/{accountId}/clients/{clientAccountId}/users/{userId}', options)
433
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUser::Representation
434
+ command.request_object = client_user_object
435
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ClientUser::Representation
436
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ClientUser
437
+ command.params['accountId'] = account_id unless account_id.nil?
438
+ command.params['clientAccountId'] = client_account_id unless client_account_id.nil?
439
+ command.params['userId'] = user_id unless user_id.nil?
440
+ command.query['fields'] = fields unless fields.nil?
441
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
442
+ execute_or_queue_command(command, &block)
443
+ end
444
+
445
+ # Creates a creative.
446
+ # @param [String] account_id
447
+ # The account that this creative belongs to. Can be used to filter the response
448
+ # of the creatives.list method.
449
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Creative] creative_object
450
+ # @param [String] duplicate_id_mode
451
+ # Indicates if multiple creatives can share an ID or not. Default is
452
+ # NO_DUPLICATES (one ID per creative).
453
+ # @param [String] fields
454
+ # Selector specifying which fields to include in a partial response.
455
+ # @param [String] quota_user
456
+ # Available to use for quota purposes for server-side applications. Can be any
457
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
458
+ # @param [Google::Apis::RequestOptions] options
459
+ # Request-specific options
460
+ #
461
+ # @yield [result, err] Result & error if block supplied
462
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Creative] parsed result object
463
+ # @yieldparam err [StandardError] error object if request failed
464
+ #
465
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Creative]
466
+ #
467
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
468
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
469
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
470
+ def create_account_creative(account_id, creative_object = nil, duplicate_id_mode: nil, fields: nil, quota_user: nil, options: nil, &block)
471
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/creatives', options)
472
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Creative::Representation
473
+ command.request_object = creative_object
474
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Creative::Representation
475
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Creative
476
+ command.params['accountId'] = account_id unless account_id.nil?
477
+ command.query['duplicateIdMode'] = duplicate_id_mode unless duplicate_id_mode.nil?
478
+ command.query['fields'] = fields unless fields.nil?
479
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
480
+ execute_or_queue_command(command, &block)
481
+ end
482
+
483
+ # Gets a creative.
484
+ # @param [String] account_id
485
+ # The account the creative belongs to.
486
+ # @param [String] creative_id
487
+ # The ID of the creative to retrieve.
488
+ # @param [String] fields
489
+ # Selector specifying which fields to include in a partial response.
490
+ # @param [String] quota_user
491
+ # Available to use for quota purposes for server-side applications. Can be any
492
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
493
+ # @param [Google::Apis::RequestOptions] options
494
+ # Request-specific options
495
+ #
496
+ # @yield [result, err] Result & error if block supplied
497
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Creative] parsed result object
498
+ # @yieldparam err [StandardError] error object if request failed
499
+ #
500
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Creative]
501
+ #
502
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
503
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
504
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
505
+ def get_account_creative(account_id, creative_id, fields: nil, quota_user: nil, options: nil, &block)
506
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/creatives/{creativeId}', options)
507
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Creative::Representation
508
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Creative
509
+ command.params['accountId'] = account_id unless account_id.nil?
510
+ command.params['creativeId'] = creative_id unless creative_id.nil?
511
+ command.query['fields'] = fields unless fields.nil?
512
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
513
+ execute_or_queue_command(command, &block)
514
+ end
515
+
516
+ # Lists creatives.
517
+ # @param [String] account_id
518
+ # The account to list the creatives from. Specify "-" to list all creatives the
519
+ # current user has access to.
520
+ # @param [Fixnum] page_size
521
+ # Requested page size. The server may return fewer creatives than requested (due
522
+ # to timeout constraint) even if more are available via another call. If
523
+ # unspecified, server will pick an appropriate default. Acceptable values are 1
524
+ # to 1000, inclusive.
525
+ # @param [String] page_token
526
+ # A token identifying a page of results the server should return. Typically,
527
+ # this is the value of ListCreativesResponse.next_page_token returned from the
528
+ # previous call to 'ListCreatives' method.
529
+ # @param [String] query
530
+ # An optional query string to filter creatives. If no filter is specified, all
531
+ # active creatives will be returned. Supported queries are: - accountId=*
532
+ # account_id_string* - creativeId=*creative_id_string* - dealsStatus: `approved,
533
+ # conditionally_approved, disapproved, not_checked` - openAuctionStatus: `
534
+ # approved, conditionally_approved, disapproved, not_checked` - attribute: `a
535
+ # numeric attribute from the list of attributes` - disapprovalReason: `a reason
536
+ # from DisapprovalReason` Example: 'accountId=12345 AND (dealsStatus:disapproved
537
+ # AND disapprovalReason:unacceptable_content) OR attribute:47'
538
+ # @param [String] fields
539
+ # Selector specifying which fields to include in a partial response.
540
+ # @param [String] quota_user
541
+ # Available to use for quota purposes for server-side applications. Can be any
542
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
543
+ # @param [Google::Apis::RequestOptions] options
544
+ # Request-specific options
545
+ #
546
+ # @yield [result, err] Result & error if block supplied
547
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListCreativesResponse] parsed result object
548
+ # @yieldparam err [StandardError] error object if request failed
549
+ #
550
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListCreativesResponse]
551
+ #
552
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
553
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
554
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
555
+ def list_account_creatives(account_id, page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
556
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/creatives', options)
557
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListCreativesResponse::Representation
558
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListCreativesResponse
559
+ command.params['accountId'] = account_id unless account_id.nil?
560
+ command.query['pageSize'] = page_size unless page_size.nil?
561
+ command.query['pageToken'] = page_token unless page_token.nil?
562
+ command.query['query'] = query unless query.nil?
563
+ command.query['fields'] = fields unless fields.nil?
564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
565
+ execute_or_queue_command(command, &block)
566
+ end
567
+
568
+ # Stops watching a creative. Will stop push notifications being sent to the
569
+ # topics when the creative changes status.
570
+ # @param [String] account_id
571
+ # The account of the creative to stop notifications for.
572
+ # @param [String] creative_id
573
+ # The creative ID of the creative to stop notifications for. Specify "-" to
574
+ # specify stopping account level notifications.
575
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::StopWatchingCreativeRequest] stop_watching_creative_request_object
576
+ # @param [String] fields
577
+ # Selector specifying which fields to include in a partial response.
578
+ # @param [String] quota_user
579
+ # Available to use for quota purposes for server-side applications. Can be any
580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
581
+ # @param [Google::Apis::RequestOptions] options
582
+ # Request-specific options
583
+ #
584
+ # @yield [result, err] Result & error if block supplied
585
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
586
+ # @yieldparam err [StandardError] error object if request failed
587
+ #
588
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
589
+ #
590
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
591
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
592
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
593
+ def stop_watching_creative(account_id, creative_id, stop_watching_creative_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
594
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/creatives/{creativeId}:stopWatching', options)
595
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::StopWatchingCreativeRequest::Representation
596
+ command.request_object = stop_watching_creative_request_object
597
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
598
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
599
+ command.params['accountId'] = account_id unless account_id.nil?
600
+ command.params['creativeId'] = creative_id unless creative_id.nil?
601
+ command.query['fields'] = fields unless fields.nil?
602
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
603
+ execute_or_queue_command(command, &block)
604
+ end
605
+
606
+ # Updates a creative.
607
+ # @param [String] account_id
608
+ # The account that this creative belongs to. Can be used to filter the response
609
+ # of the creatives.list method.
610
+ # @param [String] creative_id
611
+ # The buyer-defined creative ID of this creative. Can be used to filter the
612
+ # response of the creatives.list method.
613
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Creative] creative_object
614
+ # @param [String] fields
615
+ # Selector specifying which fields to include in a partial response.
616
+ # @param [String] quota_user
617
+ # Available to use for quota purposes for server-side applications. Can be any
618
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
619
+ # @param [Google::Apis::RequestOptions] options
620
+ # Request-specific options
621
+ #
622
+ # @yield [result, err] Result & error if block supplied
623
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Creative] parsed result object
624
+ # @yieldparam err [StandardError] error object if request failed
625
+ #
626
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Creative]
627
+ #
628
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
629
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
630
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
631
+ def update_account_creative(account_id, creative_id, creative_object = nil, fields: nil, quota_user: nil, options: nil, &block)
632
+ command = make_simple_command(:put, 'v2beta1/accounts/{accountId}/creatives/{creativeId}', options)
633
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Creative::Representation
634
+ command.request_object = creative_object
635
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Creative::Representation
636
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Creative
637
+ command.params['accountId'] = account_id unless account_id.nil?
638
+ command.params['creativeId'] = creative_id unless creative_id.nil?
639
+ command.query['fields'] = fields unless fields.nil?
640
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
641
+ execute_or_queue_command(command, &block)
642
+ end
643
+
644
+ # Watches a creative. Will result in push notifications being sent to the topic
645
+ # when the creative changes status.
646
+ # @param [String] account_id
647
+ # The account of the creative to watch.
648
+ # @param [String] creative_id
649
+ # The creative ID to watch for status changes. Specify "-" to watch all
650
+ # creatives under the above account. If both creative-level and account-level
651
+ # notifications are sent, only a single notification will be sent to the
652
+ # creative-level notification topic.
653
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::WatchCreativeRequest] watch_creative_request_object
654
+ # @param [String] fields
655
+ # Selector specifying which fields to include in a partial response.
656
+ # @param [String] quota_user
657
+ # Available to use for quota purposes for server-side applications. Can be any
658
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
659
+ # @param [Google::Apis::RequestOptions] options
660
+ # Request-specific options
661
+ #
662
+ # @yield [result, err] Result & error if block supplied
663
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
664
+ # @yieldparam err [StandardError] error object if request failed
665
+ #
666
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
667
+ #
668
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
669
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
670
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
671
+ def watch_creative(account_id, creative_id, watch_creative_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
672
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/creatives/{creativeId}:watch', options)
673
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::WatchCreativeRequest::Representation
674
+ command.request_object = watch_creative_request_object
675
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
676
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
677
+ command.params['accountId'] = account_id unless account_id.nil?
678
+ command.params['creativeId'] = creative_id unless creative_id.nil?
679
+ command.query['fields'] = fields unless fields.nil?
680
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
681
+ execute_or_queue_command(command, &block)
682
+ end
683
+
684
+ # Associate an existing deal with a creative.
685
+ # @param [String] account_id
686
+ # The account the creative belongs to.
687
+ # @param [String] creative_id
688
+ # The ID of the creative associated with the deal.
689
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::AddDealAssociationRequest] add_deal_association_request_object
690
+ # @param [String] fields
691
+ # Selector specifying which fields to include in a partial response.
692
+ # @param [String] quota_user
693
+ # Available to use for quota purposes for server-side applications. Can be any
694
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
695
+ # @param [Google::Apis::RequestOptions] options
696
+ # Request-specific options
697
+ #
698
+ # @yield [result, err] Result & error if block supplied
699
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
700
+ # @yieldparam err [StandardError] error object if request failed
701
+ #
702
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
703
+ #
704
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
705
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
706
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
707
+ def add_deal_association(account_id, creative_id, add_deal_association_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
708
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:add', options)
709
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::AddDealAssociationRequest::Representation
710
+ command.request_object = add_deal_association_request_object
711
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
712
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
713
+ command.params['accountId'] = account_id unless account_id.nil?
714
+ command.params['creativeId'] = creative_id unless creative_id.nil?
715
+ command.query['fields'] = fields unless fields.nil?
716
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
717
+ execute_or_queue_command(command, &block)
718
+ end
719
+
720
+ # List all creative-deal associations.
721
+ # @param [String] account_id
722
+ # The account to list the associations from. Specify "-" to list all creatives
723
+ # the current user has access to.
724
+ # @param [String] creative_id
725
+ # The creative ID to list the associations from. Specify "-" to list all
726
+ # creatives under the above account.
727
+ # @param [Fixnum] page_size
728
+ # Requested page size. Server may return fewer associations than requested. If
729
+ # unspecified, server will pick an appropriate default.
730
+ # @param [String] page_token
731
+ # A token identifying a page of results the server should return. Typically,
732
+ # this is the value of ListDealAssociationsResponse.next_page_token returned
733
+ # from the previous call to 'ListDealAssociations' method.
734
+ # @param [String] query
735
+ # An optional query string to filter deal associations. If no filter is
736
+ # specified, all associations will be returned. Supported queries are: -
737
+ # accountId=*account_id_string* - creativeId=*creative_id_string* - dealsId=*
738
+ # deals_id_string* - dealsStatus:`approved, conditionally_approved, disapproved,
739
+ # not_checked` - openAuctionStatus:`approved, conditionally_approved,
740
+ # disapproved, not_checked` Example: 'dealsId=12345 AND dealsStatus:disapproved'
741
+ # @param [String] fields
742
+ # Selector specifying which fields to include in a partial response.
743
+ # @param [String] quota_user
744
+ # Available to use for quota purposes for server-side applications. Can be any
745
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
746
+ # @param [Google::Apis::RequestOptions] options
747
+ # Request-specific options
748
+ #
749
+ # @yield [result, err] Result & error if block supplied
750
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListDealAssociationsResponse] parsed result object
751
+ # @yieldparam err [StandardError] error object if request failed
752
+ #
753
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListDealAssociationsResponse]
754
+ #
755
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
756
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
757
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
758
+ def list_account_creative_deal_associations(account_id, creative_id, page_size: nil, page_token: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
759
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations', options)
760
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListDealAssociationsResponse::Representation
761
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListDealAssociationsResponse
762
+ command.params['accountId'] = account_id unless account_id.nil?
763
+ command.params['creativeId'] = creative_id unless creative_id.nil?
764
+ command.query['pageSize'] = page_size unless page_size.nil?
765
+ command.query['pageToken'] = page_token unless page_token.nil?
766
+ command.query['query'] = query unless query.nil?
767
+ command.query['fields'] = fields unless fields.nil?
768
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
769
+ execute_or_queue_command(command, &block)
770
+ end
771
+
772
+ # Remove the association between a deal and a creative.
773
+ # @param [String] account_id
774
+ # The account the creative belongs to.
775
+ # @param [String] creative_id
776
+ # The ID of the creative associated with the deal.
777
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::RemoveDealAssociationRequest] remove_deal_association_request_object
778
+ # @param [String] fields
779
+ # Selector specifying which fields to include in a partial response.
780
+ # @param [String] quota_user
781
+ # Available to use for quota purposes for server-side applications. Can be any
782
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
783
+ # @param [Google::Apis::RequestOptions] options
784
+ # Request-specific options
785
+ #
786
+ # @yield [result, err] Result & error if block supplied
787
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
788
+ # @yieldparam err [StandardError] error object if request failed
789
+ #
790
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
791
+ #
792
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
793
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
794
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
795
+ def remove_deal_association(account_id, creative_id, remove_deal_association_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
796
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/creatives/{creativeId}/dealAssociations:remove', options)
797
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::RemoveDealAssociationRequest::Representation
798
+ command.request_object = remove_deal_association_request_object
799
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
800
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
801
+ command.params['accountId'] = account_id unless account_id.nil?
802
+ command.params['creativeId'] = creative_id unless creative_id.nil?
803
+ command.query['fields'] = fields unless fields.nil?
804
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
805
+ execute_or_queue_command(command, &block)
806
+ end
807
+
808
+ # List finalized proposals, regardless if a proposal is being renegotiated. A
809
+ # filter expression (PQL query) may be specified to filter the results. The
810
+ # notes will not be returned.
811
+ # @param [String] account_id
812
+ # Account ID of the buyer.
813
+ # @param [String] filter
814
+ # An optional PQL filter query used to query for proposals. Nested repeated
815
+ # fields, such as proposal.deals.targetingCriterion, cannot be filtered.
816
+ # @param [String] filter_syntax
817
+ # Syntax the filter is written in. Current implementation defaults to PQL but in
818
+ # the future it will be LIST_FILTER.
819
+ # @param [Fixnum] page_size
820
+ # Requested page size. The server may return fewer results than requested. If
821
+ # unspecified, the server will pick an appropriate default.
822
+ # @param [String] page_token
823
+ # The page token as returned from ListProposalsResponse.
824
+ # @param [String] fields
825
+ # Selector specifying which fields to include in a partial response.
826
+ # @param [String] quota_user
827
+ # Available to use for quota purposes for server-side applications. Can be any
828
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
829
+ # @param [Google::Apis::RequestOptions] options
830
+ # Request-specific options
831
+ #
832
+ # @yield [result, err] Result & error if block supplied
833
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse] parsed result object
834
+ # @yieldparam err [StandardError] error object if request failed
835
+ #
836
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse]
837
+ #
838
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
839
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
840
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
841
+ def list_account_finalized_proposals(account_id, filter: nil, filter_syntax: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
842
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/finalizedProposals', options)
843
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse::Representation
844
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse
845
+ command.params['accountId'] = account_id unless account_id.nil?
846
+ command.query['filter'] = filter unless filter.nil?
847
+ command.query['filterSyntax'] = filter_syntax unless filter_syntax.nil?
848
+ command.query['pageSize'] = page_size unless page_size.nil?
849
+ command.query['pageToken'] = page_token unless page_token.nil?
850
+ command.query['fields'] = fields unless fields.nil?
851
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
852
+ execute_or_queue_command(command, &block)
853
+ end
854
+
855
+ # Gets the requested product by ID.
856
+ # @param [String] account_id
857
+ # Account ID of the buyer.
858
+ # @param [String] product_id
859
+ # The ID for the product to get the head revision for.
860
+ # @param [String] fields
861
+ # Selector specifying which fields to include in a partial response.
862
+ # @param [String] quota_user
863
+ # Available to use for quota purposes for server-side applications. Can be any
864
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
865
+ # @param [Google::Apis::RequestOptions] options
866
+ # Request-specific options
867
+ #
868
+ # @yield [result, err] Result & error if block supplied
869
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Product] parsed result object
870
+ # @yieldparam err [StandardError] error object if request failed
871
+ #
872
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Product]
873
+ #
874
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
875
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
876
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
877
+ def get_account_product(account_id, product_id, fields: nil, quota_user: nil, options: nil, &block)
878
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/products/{productId}', options)
879
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Product::Representation
880
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Product
881
+ command.params['accountId'] = account_id unless account_id.nil?
882
+ command.params['productId'] = product_id unless product_id.nil?
883
+ command.query['fields'] = fields unless fields.nil?
884
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
885
+ execute_or_queue_command(command, &block)
886
+ end
887
+
888
+ # List all products visible to the buyer (optionally filtered by the specified
889
+ # PQL query).
890
+ # @param [String] account_id
891
+ # Account ID of the buyer.
892
+ # @param [String] filter
893
+ # An optional PQL query used to query for products. See https://developers.
894
+ # google.com/ad-manager/docs/pqlreference for documentation about PQL and
895
+ # examples. Nested repeated fields, such as product.targetingCriterion.
896
+ # inclusions, cannot be filtered.
897
+ # @param [Fixnum] page_size
898
+ # Requested page size. The server may return fewer results than requested. If
899
+ # unspecified, the server will pick an appropriate default.
900
+ # @param [String] page_token
901
+ # The page token as returned from ListProductsResponse.
902
+ # @param [String] fields
903
+ # Selector specifying which fields to include in a partial response.
904
+ # @param [String] quota_user
905
+ # Available to use for quota purposes for server-side applications. Can be any
906
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
907
+ # @param [Google::Apis::RequestOptions] options
908
+ # Request-specific options
909
+ #
910
+ # @yield [result, err] Result & error if block supplied
911
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListProductsResponse] parsed result object
912
+ # @yieldparam err [StandardError] error object if request failed
913
+ #
914
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListProductsResponse]
915
+ #
916
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
917
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
918
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
919
+ def list_account_products(account_id, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
920
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/products', options)
921
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListProductsResponse::Representation
922
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListProductsResponse
923
+ command.params['accountId'] = account_id unless account_id.nil?
924
+ command.query['filter'] = filter unless filter.nil?
925
+ command.query['pageSize'] = page_size unless page_size.nil?
926
+ command.query['pageToken'] = page_token unless page_token.nil?
927
+ command.query['fields'] = fields unless fields.nil?
928
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
929
+ execute_or_queue_command(command, &block)
930
+ end
931
+
932
+ # Mark the proposal as accepted at the given revision number. If the number does
933
+ # not match the server's revision number an `ABORTED` error message will be
934
+ # returned. This call updates the proposal_state from `PROPOSED` to `
935
+ # BUYER_ACCEPTED`, or from `SELLER_ACCEPTED` to `FINALIZED`. Upon calling this
936
+ # endpoint, the buyer implicitly agrees to the terms and conditions optionally
937
+ # set within the proposal by the publisher.
938
+ # @param [String] account_id
939
+ # Account ID of the buyer.
940
+ # @param [String] proposal_id
941
+ # The ID of the proposal to accept.
942
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::AcceptProposalRequest] accept_proposal_request_object
943
+ # @param [String] fields
944
+ # Selector specifying which fields to include in a partial response.
945
+ # @param [String] quota_user
946
+ # Available to use for quota purposes for server-side applications. Can be any
947
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
948
+ # @param [Google::Apis::RequestOptions] options
949
+ # Request-specific options
950
+ #
951
+ # @yield [result, err] Result & error if block supplied
952
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
953
+ # @yieldparam err [StandardError] error object if request failed
954
+ #
955
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
956
+ #
957
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
958
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
959
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
960
+ def accept_proposal(account_id, proposal_id, accept_proposal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
961
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:accept', options)
962
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::AcceptProposalRequest::Representation
963
+ command.request_object = accept_proposal_request_object
964
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
965
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
966
+ command.params['accountId'] = account_id unless account_id.nil?
967
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
968
+ command.query['fields'] = fields unless fields.nil?
969
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
970
+ execute_or_queue_command(command, &block)
971
+ end
972
+
973
+ # Create a new note and attach it to the proposal. The note is assigned a unique
974
+ # ID by the server. The proposal revision number will not increase when
975
+ # associated with a new note.
976
+ # @param [String] account_id
977
+ # Account ID of the buyer.
978
+ # @param [String] proposal_id
979
+ # The ID of the proposal to attach the note to.
980
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::AddNoteRequest] add_note_request_object
981
+ # @param [String] fields
982
+ # Selector specifying which fields to include in a partial response.
983
+ # @param [String] quota_user
984
+ # Available to use for quota purposes for server-side applications. Can be any
985
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
986
+ # @param [Google::Apis::RequestOptions] options
987
+ # Request-specific options
988
+ #
989
+ # @yield [result, err] Result & error if block supplied
990
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Note] parsed result object
991
+ # @yieldparam err [StandardError] error object if request failed
992
+ #
993
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Note]
994
+ #
995
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
996
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
997
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
998
+ def add_proposal_note(account_id, proposal_id, add_note_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
999
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:addNote', options)
1000
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::AddNoteRequest::Representation
1001
+ command.request_object = add_note_request_object
1002
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Note::Representation
1003
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Note
1004
+ command.params['accountId'] = account_id unless account_id.nil?
1005
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1006
+ command.query['fields'] = fields unless fields.nil?
1007
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1008
+ execute_or_queue_command(command, &block)
1009
+ end
1010
+
1011
+ # Cancel an ongoing negotiation on a proposal. This does not cancel or end
1012
+ # serving for the deals if the proposal has been finalized, but only cancels a
1013
+ # negotiation unilaterally.
1014
+ # @param [String] account_id
1015
+ # Account ID of the buyer.
1016
+ # @param [String] proposal_id
1017
+ # The ID of the proposal to cancel negotiation for.
1018
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::CancelNegotiationRequest] cancel_negotiation_request_object
1019
+ # @param [String] fields
1020
+ # Selector specifying which fields to include in a partial response.
1021
+ # @param [String] quota_user
1022
+ # Available to use for quota purposes for server-side applications. Can be any
1023
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1024
+ # @param [Google::Apis::RequestOptions] options
1025
+ # Request-specific options
1026
+ #
1027
+ # @yield [result, err] Result & error if block supplied
1028
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1029
+ # @yieldparam err [StandardError] error object if request failed
1030
+ #
1031
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1032
+ #
1033
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1034
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1035
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1036
+ def cancel_proposal_negotiation(account_id, proposal_id, cancel_negotiation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1037
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:cancelNegotiation', options)
1038
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::CancelNegotiationRequest::Representation
1039
+ command.request_object = cancel_negotiation_request_object
1040
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1041
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1042
+ command.params['accountId'] = account_id unless account_id.nil?
1043
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1044
+ command.query['fields'] = fields unless fields.nil?
1045
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1046
+ execute_or_queue_command(command, &block)
1047
+ end
1048
+
1049
+ # Update the given proposal to indicate that setup has been completed. This
1050
+ # method is called by the buyer when the line items have been created on their
1051
+ # end for a finalized proposal and all the required creatives have been uploaded
1052
+ # using the creatives API. This call updates the `is_setup_completed` bit on the
1053
+ # proposal and also notifies the seller. The server will advance the revision
1054
+ # number of the most recent proposal.
1055
+ # @param [String] account_id
1056
+ # Account ID of the buyer.
1057
+ # @param [String] proposal_id
1058
+ # The ID of the proposal to mark as setup completed.
1059
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::CompleteSetupRequest] complete_setup_request_object
1060
+ # @param [String] fields
1061
+ # Selector specifying which fields to include in a partial response.
1062
+ # @param [String] quota_user
1063
+ # Available to use for quota purposes for server-side applications. Can be any
1064
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1065
+ # @param [Google::Apis::RequestOptions] options
1066
+ # Request-specific options
1067
+ #
1068
+ # @yield [result, err] Result & error if block supplied
1069
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1070
+ # @yieldparam err [StandardError] error object if request failed
1071
+ #
1072
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1073
+ #
1074
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1075
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1076
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1077
+ def complete_proposal_setup(account_id, proposal_id, complete_setup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1078
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:completeSetup', options)
1079
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::CompleteSetupRequest::Representation
1080
+ command.request_object = complete_setup_request_object
1081
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1082
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1083
+ command.params['accountId'] = account_id unless account_id.nil?
1084
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1085
+ command.query['fields'] = fields unless fields.nil?
1086
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1087
+ execute_or_queue_command(command, &block)
1088
+ end
1089
+
1090
+ # Create the given proposal. Each created proposal and any deals it contains are
1091
+ # assigned a unique ID by the server.
1092
+ # @param [String] account_id
1093
+ # Account ID of the buyer.
1094
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Proposal] proposal_object
1095
+ # @param [String] fields
1096
+ # Selector specifying which fields to include in a partial response.
1097
+ # @param [String] quota_user
1098
+ # Available to use for quota purposes for server-side applications. Can be any
1099
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1100
+ # @param [Google::Apis::RequestOptions] options
1101
+ # Request-specific options
1102
+ #
1103
+ # @yield [result, err] Result & error if block supplied
1104
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1105
+ # @yieldparam err [StandardError] error object if request failed
1106
+ #
1107
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1108
+ #
1109
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1110
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1111
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1112
+ def create_account_proposal(account_id, proposal_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1113
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals', options)
1114
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1115
+ command.request_object = proposal_object
1116
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1117
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1118
+ command.params['accountId'] = account_id unless account_id.nil?
1119
+ command.query['fields'] = fields unless fields.nil?
1120
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1121
+ execute_or_queue_command(command, &block)
1122
+ end
1123
+
1124
+ # Gets a proposal given its ID. The proposal is returned at its head revision.
1125
+ # @param [String] account_id
1126
+ # Account ID of the buyer.
1127
+ # @param [String] proposal_id
1128
+ # The unique ID of the proposal
1129
+ # @param [String] fields
1130
+ # Selector specifying which fields to include in a partial response.
1131
+ # @param [String] quota_user
1132
+ # Available to use for quota purposes for server-side applications. Can be any
1133
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1134
+ # @param [Google::Apis::RequestOptions] options
1135
+ # Request-specific options
1136
+ #
1137
+ # @yield [result, err] Result & error if block supplied
1138
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1139
+ # @yieldparam err [StandardError] error object if request failed
1140
+ #
1141
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1142
+ #
1143
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1144
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1145
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1146
+ def get_account_proposal(account_id, proposal_id, fields: nil, quota_user: nil, options: nil, &block)
1147
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/proposals/{proposalId}', options)
1148
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1149
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1150
+ command.params['accountId'] = account_id unless account_id.nil?
1151
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1152
+ command.query['fields'] = fields unless fields.nil?
1153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1154
+ execute_or_queue_command(command, &block)
1155
+ end
1156
+
1157
+ # List proposals. A filter expression (PQL query) may be specified to filter the
1158
+ # results. To retrieve all finalized proposals, regardless if a proposal is
1159
+ # being renegotiated, see the FinalizedProposals resource. Note that Bidder/
1160
+ # ChildSeat relationships differ from the usual behavior. A Bidder account can
1161
+ # only see its child seats' proposals by specifying the ChildSeat's accountId in
1162
+ # the request path.
1163
+ # @param [String] account_id
1164
+ # Account ID of the buyer.
1165
+ # @param [String] filter
1166
+ # An optional PQL filter query used to query for proposals. Nested repeated
1167
+ # fields, such as proposal.deals.targetingCriterion, cannot be filtered.
1168
+ # @param [String] filter_syntax
1169
+ # Syntax the filter is written in. Current implementation defaults to PQL but in
1170
+ # the future it will be LIST_FILTER.
1171
+ # @param [Fixnum] page_size
1172
+ # Requested page size. The server may return fewer results than requested. If
1173
+ # unspecified, the server will pick an appropriate default.
1174
+ # @param [String] page_token
1175
+ # The page token as returned from ListProposalsResponse.
1176
+ # @param [String] fields
1177
+ # Selector specifying which fields to include in a partial response.
1178
+ # @param [String] quota_user
1179
+ # Available to use for quota purposes for server-side applications. Can be any
1180
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1181
+ # @param [Google::Apis::RequestOptions] options
1182
+ # Request-specific options
1183
+ #
1184
+ # @yield [result, err] Result & error if block supplied
1185
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse] parsed result object
1186
+ # @yieldparam err [StandardError] error object if request failed
1187
+ #
1188
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse]
1189
+ #
1190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1193
+ def list_account_proposals(account_id, filter: nil, filter_syntax: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1194
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/proposals', options)
1195
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse::Representation
1196
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListProposalsResponse
1197
+ command.params['accountId'] = account_id unless account_id.nil?
1198
+ command.query['filter'] = filter unless filter.nil?
1199
+ command.query['filterSyntax'] = filter_syntax unless filter_syntax.nil?
1200
+ command.query['pageSize'] = page_size unless page_size.nil?
1201
+ command.query['pageToken'] = page_token unless page_token.nil?
1202
+ command.query['fields'] = fields unless fields.nil?
1203
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1204
+ execute_or_queue_command(command, &block)
1205
+ end
1206
+
1207
+ # Update the given proposal to pause serving. This method will set the `
1208
+ # DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to true for all
1209
+ # deals in the proposal. It is a no-op to pause an already-paused proposal. It
1210
+ # is an error to call PauseProposal for a proposal that is not finalized or
1211
+ # renegotiating.
1212
+ # @param [String] account_id
1213
+ # Account ID of the buyer.
1214
+ # @param [String] proposal_id
1215
+ # The ID of the proposal to pause.
1216
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::PauseProposalRequest] pause_proposal_request_object
1217
+ # @param [String] fields
1218
+ # Selector specifying which fields to include in a partial response.
1219
+ # @param [String] quota_user
1220
+ # Available to use for quota purposes for server-side applications. Can be any
1221
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1222
+ # @param [Google::Apis::RequestOptions] options
1223
+ # Request-specific options
1224
+ #
1225
+ # @yield [result, err] Result & error if block supplied
1226
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1227
+ # @yieldparam err [StandardError] error object if request failed
1228
+ #
1229
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1230
+ #
1231
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1232
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1233
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1234
+ def pause_proposal(account_id, proposal_id, pause_proposal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1235
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:pause', options)
1236
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::PauseProposalRequest::Representation
1237
+ command.request_object = pause_proposal_request_object
1238
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1239
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1240
+ command.params['accountId'] = account_id unless account_id.nil?
1241
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1242
+ command.query['fields'] = fields unless fields.nil?
1243
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1244
+ execute_or_queue_command(command, &block)
1245
+ end
1246
+
1247
+ # Update the given proposal to resume serving. This method will set the `
1248
+ # DealServingMetadata.DealPauseStatus.has_buyer_paused` bit to false for all
1249
+ # deals in the proposal. Note that if the `has_seller_paused` bit is also set,
1250
+ # serving will not resume until the seller also resumes. It is a no-op to resume
1251
+ # an already-running proposal. It is an error to call ResumeProposal for a
1252
+ # proposal that is not finalized or renegotiating.
1253
+ # @param [String] account_id
1254
+ # Account ID of the buyer.
1255
+ # @param [String] proposal_id
1256
+ # The ID of the proposal to resume.
1257
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::ResumeProposalRequest] resume_proposal_request_object
1258
+ # @param [String] fields
1259
+ # Selector specifying which fields to include in a partial response.
1260
+ # @param [String] quota_user
1261
+ # Available to use for quota purposes for server-side applications. Can be any
1262
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1263
+ # @param [Google::Apis::RequestOptions] options
1264
+ # Request-specific options
1265
+ #
1266
+ # @yield [result, err] Result & error if block supplied
1267
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1268
+ # @yieldparam err [StandardError] error object if request failed
1269
+ #
1270
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1271
+ #
1272
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1273
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1274
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1275
+ def resume_proposal(account_id, proposal_id, resume_proposal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1276
+ command = make_simple_command(:post, 'v2beta1/accounts/{accountId}/proposals/{proposalId}:resume', options)
1277
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::ResumeProposalRequest::Representation
1278
+ command.request_object = resume_proposal_request_object
1279
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1280
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1281
+ command.params['accountId'] = account_id unless account_id.nil?
1282
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1283
+ command.query['fields'] = fields unless fields.nil?
1284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1285
+ execute_or_queue_command(command, &block)
1286
+ end
1287
+
1288
+ # Update the given proposal at the client known revision number. If the server
1289
+ # revision has advanced since the passed-in `proposal.proposal_revision`, an `
1290
+ # ABORTED` error message will be returned. Only the buyer-modifiable fields of
1291
+ # the proposal will be updated. Note that the deals in the proposal will be
1292
+ # updated to match the passed-in copy. If a passed-in deal does not have a `
1293
+ # deal_id`, the server will assign a new unique ID and create the deal. If
1294
+ # passed-in deal has a `deal_id`, it will be updated to match the passed-in copy.
1295
+ # Any existing deals not present in the passed-in proposal will be deleted. It
1296
+ # is an error to pass in a deal with a `deal_id` not present at head.
1297
+ # @param [String] account_id
1298
+ # Account ID of the buyer.
1299
+ # @param [String] proposal_id
1300
+ # The unique ID of the proposal.
1301
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::Proposal] proposal_object
1302
+ # @param [String] fields
1303
+ # Selector specifying which fields to include in a partial response.
1304
+ # @param [String] quota_user
1305
+ # Available to use for quota purposes for server-side applications. Can be any
1306
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1307
+ # @param [Google::Apis::RequestOptions] options
1308
+ # Request-specific options
1309
+ #
1310
+ # @yield [result, err] Result & error if block supplied
1311
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Proposal] parsed result object
1312
+ # @yieldparam err [StandardError] error object if request failed
1313
+ #
1314
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Proposal]
1315
+ #
1316
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1317
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1318
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1319
+ def update_account_proposal(account_id, proposal_id, proposal_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1320
+ command = make_simple_command(:put, 'v2beta1/accounts/{accountId}/proposals/{proposalId}', options)
1321
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1322
+ command.request_object = proposal_object
1323
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Proposal::Representation
1324
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Proposal
1325
+ command.params['accountId'] = account_id unless account_id.nil?
1326
+ command.params['proposalId'] = proposal_id unless proposal_id.nil?
1327
+ command.query['fields'] = fields unless fields.nil?
1328
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1329
+ execute_or_queue_command(command, &block)
1330
+ end
1331
+
1332
+ # Gets the requested publisher profile by id.
1333
+ # @param [String] account_id
1334
+ # Account ID of the buyer.
1335
+ # @param [String] publisher_profile_id
1336
+ # The id for the publisher profile to get.
1337
+ # @param [String] fields
1338
+ # Selector specifying which fields to include in a partial response.
1339
+ # @param [String] quota_user
1340
+ # Available to use for quota purposes for server-side applications. Can be any
1341
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1342
+ # @param [Google::Apis::RequestOptions] options
1343
+ # Request-specific options
1344
+ #
1345
+ # @yield [result, err] Result & error if block supplied
1346
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::PublisherProfile] parsed result object
1347
+ # @yieldparam err [StandardError] error object if request failed
1348
+ #
1349
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::PublisherProfile]
1350
+ #
1351
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1352
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1353
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1354
+ def get_account_publisher_profile(account_id, publisher_profile_id, fields: nil, quota_user: nil, options: nil, &block)
1355
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/publisherProfiles/{publisherProfileId}', options)
1356
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::PublisherProfile::Representation
1357
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::PublisherProfile
1358
+ command.params['accountId'] = account_id unless account_id.nil?
1359
+ command.params['publisherProfileId'] = publisher_profile_id unless publisher_profile_id.nil?
1360
+ command.query['fields'] = fields unless fields.nil?
1361
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1362
+ execute_or_queue_command(command, &block)
1363
+ end
1364
+
1365
+ # List all publisher profiles visible to the buyer
1366
+ # @param [String] account_id
1367
+ # Account ID of the buyer.
1368
+ # @param [Fixnum] page_size
1369
+ # Specify the number of results to include per page.
1370
+ # @param [String] page_token
1371
+ # The page token as return from ListPublisherProfilesResponse.
1372
+ # @param [String] fields
1373
+ # Selector specifying which fields to include in a partial response.
1374
+ # @param [String] quota_user
1375
+ # Available to use for quota purposes for server-side applications. Can be any
1376
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1377
+ # @param [Google::Apis::RequestOptions] options
1378
+ # Request-specific options
1379
+ #
1380
+ # @yield [result, err] Result & error if block supplied
1381
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListPublisherProfilesResponse] parsed result object
1382
+ # @yieldparam err [StandardError] error object if request failed
1383
+ #
1384
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListPublisherProfilesResponse]
1385
+ #
1386
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1387
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1388
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1389
+ def list_account_publisher_profiles(account_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1390
+ command = make_simple_command(:get, 'v2beta1/accounts/{accountId}/publisherProfiles', options)
1391
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListPublisherProfilesResponse::Representation
1392
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListPublisherProfilesResponse
1393
+ command.params['accountId'] = account_id unless account_id.nil?
1394
+ command.query['pageSize'] = page_size unless page_size.nil?
1395
+ command.query['pageToken'] = page_token unless page_token.nil?
1396
+ command.query['fields'] = fields unless fields.nil?
1397
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1398
+ execute_or_queue_command(command, &block)
1399
+ end
1400
+
1401
+ # Creates the specified filter set for the account with the given account ID.
1402
+ # @param [String] owner_name
1403
+ # Name of the owner (bidder or account) of the filter set to be created. For
1404
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123` - For
1405
+ # an account-level filter set for the buyer account representing bidder 123: `
1406
+ # bidders/123/accounts/123` - For an account-level filter set for the child seat
1407
+ # buyer account 456 whose bidder is 123: `bidders/123/accounts/456`
1408
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] filter_set_object
1409
+ # @param [Boolean] is_transient
1410
+ # Whether the filter set is transient, or should be persisted indefinitely. By
1411
+ # default, filter sets are not transient. If transient, it will be available for
1412
+ # at least 1 hour after creation.
1413
+ # @param [String] fields
1414
+ # Selector specifying which fields to include in a partial response.
1415
+ # @param [String] quota_user
1416
+ # Available to use for quota purposes for server-side applications. Can be any
1417
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1418
+ # @param [Google::Apis::RequestOptions] options
1419
+ # Request-specific options
1420
+ #
1421
+ # @yield [result, err] Result & error if block supplied
1422
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] parsed result object
1423
+ # @yieldparam err [StandardError] error object if request failed
1424
+ #
1425
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::FilterSet]
1426
+ #
1427
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1428
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1429
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1430
+ def create_bidder_account_filter_set(owner_name, filter_set_object = nil, is_transient: nil, fields: nil, quota_user: nil, options: nil, &block)
1431
+ command = make_simple_command(:post, 'v2beta1/{+ownerName}/filterSets', options)
1432
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
1433
+ command.request_object = filter_set_object
1434
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
1435
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::FilterSet
1436
+ command.params['ownerName'] = owner_name unless owner_name.nil?
1437
+ command.query['isTransient'] = is_transient unless is_transient.nil?
1438
+ command.query['fields'] = fields unless fields.nil?
1439
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1440
+ execute_or_queue_command(command, &block)
1441
+ end
1442
+
1443
+ # Deletes the requested filter set from the account with the given account ID.
1444
+ # @param [String] name
1445
+ # Full name of the resource to delete. For example: - For a bidder-level filter
1446
+ # set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter
1447
+ # set for the buyer account representing bidder 123: `bidders/123/accounts/123/
1448
+ # filterSets/abc` - For an account-level filter set for the child seat buyer
1449
+ # account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`
1450
+ # @param [String] fields
1451
+ # Selector specifying which fields to include in a partial response.
1452
+ # @param [String] quota_user
1453
+ # Available to use for quota purposes for server-side applications. Can be any
1454
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1455
+ # @param [Google::Apis::RequestOptions] options
1456
+ # Request-specific options
1457
+ #
1458
+ # @yield [result, err] Result & error if block supplied
1459
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
1460
+ # @yieldparam err [StandardError] error object if request failed
1461
+ #
1462
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
1463
+ #
1464
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1465
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1466
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1467
+ def delete_bidder_account_filter_set(name, fields: nil, quota_user: nil, options: nil, &block)
1468
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
1469
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
1470
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
1471
+ command.params['name'] = name unless name.nil?
1472
+ command.query['fields'] = fields unless fields.nil?
1473
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1474
+ execute_or_queue_command(command, &block)
1475
+ end
1476
+
1477
+ # Retrieves the requested filter set for the account with the given account ID.
1478
+ # @param [String] name
1479
+ # Full name of the resource being requested. For example: - For a bidder-level
1480
+ # filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level
1481
+ # filter set for the buyer account representing bidder 123: `bidders/123/
1482
+ # accounts/123/filterSets/abc` - For an account-level filter set for the child
1483
+ # seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/
1484
+ # filterSets/abc`
1485
+ # @param [String] fields
1486
+ # Selector specifying which fields to include in a partial response.
1487
+ # @param [String] quota_user
1488
+ # Available to use for quota purposes for server-side applications. Can be any
1489
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1490
+ # @param [Google::Apis::RequestOptions] options
1491
+ # Request-specific options
1492
+ #
1493
+ # @yield [result, err] Result & error if block supplied
1494
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] parsed result object
1495
+ # @yieldparam err [StandardError] error object if request failed
1496
+ #
1497
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::FilterSet]
1498
+ #
1499
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1500
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1501
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1502
+ def get_bidder_account_filter_set(name, fields: nil, quota_user: nil, options: nil, &block)
1503
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
1504
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
1505
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::FilterSet
1506
+ command.params['name'] = name unless name.nil?
1507
+ command.query['fields'] = fields unless fields.nil?
1508
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1509
+ execute_or_queue_command(command, &block)
1510
+ end
1511
+
1512
+ # Lists all filter sets for the account with the given account ID.
1513
+ # @param [String] owner_name
1514
+ # Name of the owner (bidder or account) of the filter sets to be listed. For
1515
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123` - For
1516
+ # an account-level filter set for the buyer account representing bidder 123: `
1517
+ # bidders/123/accounts/123` - For an account-level filter set for the child seat
1518
+ # buyer account 456 whose bidder is 123: `bidders/123/accounts/456`
1519
+ # @param [Fixnum] page_size
1520
+ # Requested page size. The server may return fewer results than requested. If
1521
+ # unspecified, the server will pick an appropriate default.
1522
+ # @param [String] page_token
1523
+ # A token identifying a page of results the server should return. Typically,
1524
+ # this is the value of ListFilterSetsResponse.nextPageToken returned from the
1525
+ # previous call to the accounts.filterSets.list method.
1526
+ # @param [String] fields
1527
+ # Selector specifying which fields to include in a partial response.
1528
+ # @param [String] quota_user
1529
+ # Available to use for quota purposes for server-side applications. Can be any
1530
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1531
+ # @param [Google::Apis::RequestOptions] options
1532
+ # Request-specific options
1533
+ #
1534
+ # @yield [result, err] Result & error if block supplied
1535
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse] parsed result object
1536
+ # @yieldparam err [StandardError] error object if request failed
1537
+ #
1538
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse]
1539
+ #
1540
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1541
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1542
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1543
+ def list_bidder_account_filter_sets(owner_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1544
+ command = make_simple_command(:get, 'v2beta1/{+ownerName}/filterSets', options)
1545
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse::Representation
1546
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse
1547
+ command.params['ownerName'] = owner_name unless owner_name.nil?
1548
+ command.query['pageSize'] = page_size unless page_size.nil?
1549
+ command.query['pageToken'] = page_token unless page_token.nil?
1550
+ command.query['fields'] = fields unless fields.nil?
1551
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1552
+ execute_or_queue_command(command, &block)
1553
+ end
1554
+
1555
+ # Lists all metrics that are measured in terms of number of bids.
1556
+ # @param [String] filter_set_name
1557
+ # Name of the filter set that should be applied to the requested metrics. For
1558
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1559
+ # filterSets/abc` - For an account-level filter set for the buyer account
1560
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1561
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1562
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1563
+ # @param [Fixnum] page_size
1564
+ # Requested page size. The server may return fewer results than requested. If
1565
+ # unspecified, the server will pick an appropriate default.
1566
+ # @param [String] page_token
1567
+ # A token identifying a page of results the server should return. Typically,
1568
+ # this is the value of ListBidMetricsResponse.nextPageToken returned from the
1569
+ # previous call to the bidMetrics.list method.
1570
+ # @param [String] fields
1571
+ # Selector specifying which fields to include in a partial response.
1572
+ # @param [String] quota_user
1573
+ # Available to use for quota purposes for server-side applications. Can be any
1574
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1575
+ # @param [Google::Apis::RequestOptions] options
1576
+ # Request-specific options
1577
+ #
1578
+ # @yield [result, err] Result & error if block supplied
1579
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse] parsed result object
1580
+ # @yieldparam err [StandardError] error object if request failed
1581
+ #
1582
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse]
1583
+ #
1584
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1585
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1586
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1587
+ def list_bidder_account_filter_set_bid_metrics(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1588
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidMetrics', options)
1589
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse::Representation
1590
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse
1591
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1592
+ command.query['pageSize'] = page_size unless page_size.nil?
1593
+ command.query['pageToken'] = page_token unless page_token.nil?
1594
+ command.query['fields'] = fields unless fields.nil?
1595
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1596
+ execute_or_queue_command(command, &block)
1597
+ end
1598
+
1599
+ # List all errors that occurred in bid responses, with the number of bid
1600
+ # responses affected for each reason.
1601
+ # @param [String] filter_set_name
1602
+ # Name of the filter set that should be applied to the requested metrics. For
1603
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1604
+ # filterSets/abc` - For an account-level filter set for the buyer account
1605
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1606
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1607
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1608
+ # @param [Fixnum] page_size
1609
+ # Requested page size. The server may return fewer results than requested. If
1610
+ # unspecified, the server will pick an appropriate default.
1611
+ # @param [String] page_token
1612
+ # A token identifying a page of results the server should return. Typically,
1613
+ # this is the value of ListBidResponseErrorsResponse.nextPageToken returned from
1614
+ # the previous call to the bidResponseErrors.list method.
1615
+ # @param [String] fields
1616
+ # Selector specifying which fields to include in a partial response.
1617
+ # @param [String] quota_user
1618
+ # Available to use for quota purposes for server-side applications. Can be any
1619
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1620
+ # @param [Google::Apis::RequestOptions] options
1621
+ # Request-specific options
1622
+ #
1623
+ # @yield [result, err] Result & error if block supplied
1624
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse] parsed result object
1625
+ # @yieldparam err [StandardError] error object if request failed
1626
+ #
1627
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse]
1628
+ #
1629
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1630
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1631
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1632
+ def list_bidder_account_filter_set_bid_response_errors(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1633
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidResponseErrors', options)
1634
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse::Representation
1635
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse
1636
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1637
+ command.query['pageSize'] = page_size unless page_size.nil?
1638
+ command.query['pageToken'] = page_token unless page_token.nil?
1639
+ command.query['fields'] = fields unless fields.nil?
1640
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1641
+ execute_or_queue_command(command, &block)
1642
+ end
1643
+
1644
+ # List all reasons for which bid responses were considered to have no applicable
1645
+ # bids, with the number of bid responses affected for each reason.
1646
+ # @param [String] filter_set_name
1647
+ # Name of the filter set that should be applied to the requested metrics. For
1648
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1649
+ # filterSets/abc` - For an account-level filter set for the buyer account
1650
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1651
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1652
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1653
+ # @param [Fixnum] page_size
1654
+ # Requested page size. The server may return fewer results than requested. If
1655
+ # unspecified, the server will pick an appropriate default.
1656
+ # @param [String] page_token
1657
+ # A token identifying a page of results the server should return. Typically,
1658
+ # this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken
1659
+ # returned from the previous call to the bidResponsesWithoutBids.list method.
1660
+ # @param [String] fields
1661
+ # Selector specifying which fields to include in a partial response.
1662
+ # @param [String] quota_user
1663
+ # Available to use for quota purposes for server-side applications. Can be any
1664
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1665
+ # @param [Google::Apis::RequestOptions] options
1666
+ # Request-specific options
1667
+ #
1668
+ # @yield [result, err] Result & error if block supplied
1669
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse] parsed result object
1670
+ # @yieldparam err [StandardError] error object if request failed
1671
+ #
1672
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse]
1673
+ #
1674
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1675
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1676
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1677
+ def list_bidder_account_filter_set_bid_responses_without_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1678
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidResponsesWithoutBids', options)
1679
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse::Representation
1680
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse
1681
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1682
+ command.query['pageSize'] = page_size unless page_size.nil?
1683
+ command.query['pageToken'] = page_token unless page_token.nil?
1684
+ command.query['fields'] = fields unless fields.nil?
1685
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1686
+ execute_or_queue_command(command, &block)
1687
+ end
1688
+
1689
+ # List all reasons that caused a bid request not to be sent for an impression,
1690
+ # with the number of bid requests not sent for each reason.
1691
+ # @param [String] filter_set_name
1692
+ # Name of the filter set that should be applied to the requested metrics. For
1693
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1694
+ # filterSets/abc` - For an account-level filter set for the buyer account
1695
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1696
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1697
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1698
+ # @param [Fixnum] page_size
1699
+ # Requested page size. The server may return fewer results than requested. If
1700
+ # unspecified, the server will pick an appropriate default.
1701
+ # @param [String] page_token
1702
+ # A token identifying a page of results the server should return. Typically,
1703
+ # this is the value of ListFilteredBidRequestsResponse.nextPageToken returned
1704
+ # from the previous call to the filteredBidRequests.list method.
1705
+ # @param [String] fields
1706
+ # Selector specifying which fields to include in a partial response.
1707
+ # @param [String] quota_user
1708
+ # Available to use for quota purposes for server-side applications. Can be any
1709
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1710
+ # @param [Google::Apis::RequestOptions] options
1711
+ # Request-specific options
1712
+ #
1713
+ # @yield [result, err] Result & error if block supplied
1714
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse] parsed result object
1715
+ # @yieldparam err [StandardError] error object if request failed
1716
+ #
1717
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse]
1718
+ #
1719
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1720
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1721
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1722
+ def list_bidder_account_filter_set_filtered_bid_requests(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1723
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBidRequests', options)
1724
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse::Representation
1725
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse
1726
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1727
+ command.query['pageSize'] = page_size unless page_size.nil?
1728
+ command.query['pageToken'] = page_token unless page_token.nil?
1729
+ command.query['fields'] = fields unless fields.nil?
1730
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1731
+ execute_or_queue_command(command, &block)
1732
+ end
1733
+
1734
+ # List all reasons for which bids were filtered, with the number of bids
1735
+ # filtered for each reason.
1736
+ # @param [String] filter_set_name
1737
+ # Name of the filter set that should be applied to the requested metrics. For
1738
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1739
+ # filterSets/abc` - For an account-level filter set for the buyer account
1740
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1741
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1742
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1743
+ # @param [Fixnum] page_size
1744
+ # Requested page size. The server may return fewer results than requested. If
1745
+ # unspecified, the server will pick an appropriate default.
1746
+ # @param [String] page_token
1747
+ # A token identifying a page of results the server should return. Typically,
1748
+ # this is the value of ListFilteredBidsResponse.nextPageToken returned from the
1749
+ # previous call to the filteredBids.list method.
1750
+ # @param [String] fields
1751
+ # Selector specifying which fields to include in a partial response.
1752
+ # @param [String] quota_user
1753
+ # Available to use for quota purposes for server-side applications. Can be any
1754
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1755
+ # @param [Google::Apis::RequestOptions] options
1756
+ # Request-specific options
1757
+ #
1758
+ # @yield [result, err] Result & error if block supplied
1759
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse] parsed result object
1760
+ # @yieldparam err [StandardError] error object if request failed
1761
+ #
1762
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse]
1763
+ #
1764
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1765
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1766
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1767
+ def list_bidder_account_filter_set_filtered_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1768
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids', options)
1769
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse::Representation
1770
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse
1771
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1772
+ command.query['pageSize'] = page_size unless page_size.nil?
1773
+ command.query['pageToken'] = page_token unless page_token.nil?
1774
+ command.query['fields'] = fields unless fields.nil?
1775
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1776
+ execute_or_queue_command(command, &block)
1777
+ end
1778
+
1779
+ # List all creatives associated with a specific reason for which bids were
1780
+ # filtered, with the number of bids filtered for each creative.
1781
+ # @param [String] filter_set_name
1782
+ # Name of the filter set that should be applied to the requested metrics. For
1783
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1784
+ # filterSets/abc` - For an account-level filter set for the buyer account
1785
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1786
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1787
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1788
+ # @param [Fixnum] creative_status_id
1789
+ # The ID of the creative status for which to retrieve a breakdown by creative.
1790
+ # See [creative-status-codes](https://developers.google.com/authorized-buyers/
1791
+ # rtb/downloads/creative-status-codes).
1792
+ # @param [Fixnum] page_size
1793
+ # Requested page size. The server may return fewer results than requested. If
1794
+ # unspecified, the server will pick an appropriate default.
1795
+ # @param [String] page_token
1796
+ # A token identifying a page of results the server should return. Typically,
1797
+ # this is the value of ListCreativeStatusBreakdownByCreativeResponse.
1798
+ # nextPageToken returned from the previous call to the filteredBids.creatives.
1799
+ # list method.
1800
+ # @param [String] fields
1801
+ # Selector specifying which fields to include in a partial response.
1802
+ # @param [String] quota_user
1803
+ # Available to use for quota purposes for server-side applications. Can be any
1804
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1805
+ # @param [Google::Apis::RequestOptions] options
1806
+ # Request-specific options
1807
+ #
1808
+ # @yield [result, err] Result & error if block supplied
1809
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse] parsed result object
1810
+ # @yieldparam err [StandardError] error object if request failed
1811
+ #
1812
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse]
1813
+ #
1814
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1815
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1816
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1817
+ def list_bidder_account_filter_set_filtered_bid_creatives(filter_set_name, creative_status_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1818
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives', options)
1819
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse::Representation
1820
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse
1821
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1822
+ command.params['creativeStatusId'] = creative_status_id unless creative_status_id.nil?
1823
+ command.query['pageSize'] = page_size unless page_size.nil?
1824
+ command.query['pageToken'] = page_token unless page_token.nil?
1825
+ command.query['fields'] = fields unless fields.nil?
1826
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1827
+ execute_or_queue_command(command, &block)
1828
+ end
1829
+
1830
+ # List all details associated with a specific reason for which bids were
1831
+ # filtered, with the number of bids filtered for each detail.
1832
+ # @param [String] filter_set_name
1833
+ # Name of the filter set that should be applied to the requested metrics. For
1834
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1835
+ # filterSets/abc` - For an account-level filter set for the buyer account
1836
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1837
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1838
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1839
+ # @param [Fixnum] creative_status_id
1840
+ # The ID of the creative status for which to retrieve a breakdown by detail. See
1841
+ # [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/
1842
+ # downloads/creative-status-codes). Details are only available for statuses 10,
1843
+ # 14, 15, 17, 18, 19, 86, and 87.
1844
+ # @param [Fixnum] page_size
1845
+ # Requested page size. The server may return fewer results than requested. If
1846
+ # unspecified, the server will pick an appropriate default.
1847
+ # @param [String] page_token
1848
+ # A token identifying a page of results the server should return. Typically,
1849
+ # this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken
1850
+ # returned from the previous call to the filteredBids.details.list method.
1851
+ # @param [String] fields
1852
+ # Selector specifying which fields to include in a partial response.
1853
+ # @param [String] quota_user
1854
+ # Available to use for quota purposes for server-side applications. Can be any
1855
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1856
+ # @param [Google::Apis::RequestOptions] options
1857
+ # Request-specific options
1858
+ #
1859
+ # @yield [result, err] Result & error if block supplied
1860
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse] parsed result object
1861
+ # @yieldparam err [StandardError] error object if request failed
1862
+ #
1863
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse]
1864
+ #
1865
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1866
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1867
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1868
+ def list_bidder_account_filter_set_filtered_bid_details(filter_set_name, creative_status_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1869
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details', options)
1870
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse::Representation
1871
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse
1872
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1873
+ command.params['creativeStatusId'] = creative_status_id unless creative_status_id.nil?
1874
+ command.query['pageSize'] = page_size unless page_size.nil?
1875
+ command.query['pageToken'] = page_token unless page_token.nil?
1876
+ command.query['fields'] = fields unless fields.nil?
1877
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1878
+ execute_or_queue_command(command, &block)
1879
+ end
1880
+
1881
+ # Lists all metrics that are measured in terms of number of impressions.
1882
+ # @param [String] filter_set_name
1883
+ # Name of the filter set that should be applied to the requested metrics. For
1884
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1885
+ # filterSets/abc` - For an account-level filter set for the buyer account
1886
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1887
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1888
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1889
+ # @param [Fixnum] page_size
1890
+ # Requested page size. The server may return fewer results than requested. If
1891
+ # unspecified, the server will pick an appropriate default.
1892
+ # @param [String] page_token
1893
+ # A token identifying a page of results the server should return. Typically,
1894
+ # this is the value of ListImpressionMetricsResponse.nextPageToken returned from
1895
+ # the previous call to the impressionMetrics.list method.
1896
+ # @param [String] fields
1897
+ # Selector specifying which fields to include in a partial response.
1898
+ # @param [String] quota_user
1899
+ # Available to use for quota purposes for server-side applications. Can be any
1900
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1901
+ # @param [Google::Apis::RequestOptions] options
1902
+ # Request-specific options
1903
+ #
1904
+ # @yield [result, err] Result & error if block supplied
1905
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse] parsed result object
1906
+ # @yieldparam err [StandardError] error object if request failed
1907
+ #
1908
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse]
1909
+ #
1910
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1911
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1912
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1913
+ def list_bidder_account_filter_set_impression_metrics(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1914
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/impressionMetrics', options)
1915
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse::Representation
1916
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse
1917
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1918
+ command.query['pageSize'] = page_size unless page_size.nil?
1919
+ command.query['pageToken'] = page_token unless page_token.nil?
1920
+ command.query['fields'] = fields unless fields.nil?
1921
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1922
+ execute_or_queue_command(command, &block)
1923
+ end
1924
+
1925
+ # List all reasons for which bids lost in the auction, with the number of bids
1926
+ # that lost for each reason.
1927
+ # @param [String] filter_set_name
1928
+ # Name of the filter set that should be applied to the requested metrics. For
1929
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1930
+ # filterSets/abc` - For an account-level filter set for the buyer account
1931
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1932
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1933
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1934
+ # @param [Fixnum] page_size
1935
+ # Requested page size. The server may return fewer results than requested. If
1936
+ # unspecified, the server will pick an appropriate default.
1937
+ # @param [String] page_token
1938
+ # A token identifying a page of results the server should return. Typically,
1939
+ # this is the value of ListLosingBidsResponse.nextPageToken returned from the
1940
+ # previous call to the losingBids.list method.
1941
+ # @param [String] fields
1942
+ # Selector specifying which fields to include in a partial response.
1943
+ # @param [String] quota_user
1944
+ # Available to use for quota purposes for server-side applications. Can be any
1945
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1946
+ # @param [Google::Apis::RequestOptions] options
1947
+ # Request-specific options
1948
+ #
1949
+ # @yield [result, err] Result & error if block supplied
1950
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse] parsed result object
1951
+ # @yieldparam err [StandardError] error object if request failed
1952
+ #
1953
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse]
1954
+ #
1955
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1956
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1957
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1958
+ def list_bidder_account_filter_set_losing_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1959
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/losingBids', options)
1960
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse::Representation
1961
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse
1962
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
1963
+ command.query['pageSize'] = page_size unless page_size.nil?
1964
+ command.query['pageToken'] = page_token unless page_token.nil?
1965
+ command.query['fields'] = fields unless fields.nil?
1966
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1967
+ execute_or_queue_command(command, &block)
1968
+ end
1969
+
1970
+ # List all reasons for which winning bids were not billable, with the number of
1971
+ # bids not billed for each reason.
1972
+ # @param [String] filter_set_name
1973
+ # Name of the filter set that should be applied to the requested metrics. For
1974
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
1975
+ # filterSets/abc` - For an account-level filter set for the buyer account
1976
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
1977
+ # account-level filter set for the child seat buyer account 456 whose bidder is
1978
+ # 123: `bidders/123/accounts/456/filterSets/abc`
1979
+ # @param [Fixnum] page_size
1980
+ # Requested page size. The server may return fewer results than requested. If
1981
+ # unspecified, the server will pick an appropriate default.
1982
+ # @param [String] page_token
1983
+ # A token identifying a page of results the server should return. Typically,
1984
+ # this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned
1985
+ # from the previous call to the nonBillableWinningBids.list method.
1986
+ # @param [String] fields
1987
+ # Selector specifying which fields to include in a partial response.
1988
+ # @param [String] quota_user
1989
+ # Available to use for quota purposes for server-side applications. Can be any
1990
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1991
+ # @param [Google::Apis::RequestOptions] options
1992
+ # Request-specific options
1993
+ #
1994
+ # @yield [result, err] Result & error if block supplied
1995
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse] parsed result object
1996
+ # @yieldparam err [StandardError] error object if request failed
1997
+ #
1998
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse]
1999
+ #
2000
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2001
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2002
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2003
+ def list_bidder_account_filter_set_non_billable_winning_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2004
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/nonBillableWinningBids', options)
2005
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse::Representation
2006
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse
2007
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2008
+ command.query['pageSize'] = page_size unless page_size.nil?
2009
+ command.query['pageToken'] = page_token unless page_token.nil?
2010
+ command.query['fields'] = fields unless fields.nil?
2011
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2012
+ execute_or_queue_command(command, &block)
2013
+ end
2014
+
2015
+ # Creates the specified filter set for the account with the given account ID.
2016
+ # @param [String] owner_name
2017
+ # Name of the owner (bidder or account) of the filter set to be created. For
2018
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123` - For
2019
+ # an account-level filter set for the buyer account representing bidder 123: `
2020
+ # bidders/123/accounts/123` - For an account-level filter set for the child seat
2021
+ # buyer account 456 whose bidder is 123: `bidders/123/accounts/456`
2022
+ # @param [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] filter_set_object
2023
+ # @param [Boolean] is_transient
2024
+ # Whether the filter set is transient, or should be persisted indefinitely. By
2025
+ # default, filter sets are not transient. If transient, it will be available for
2026
+ # at least 1 hour after creation.
2027
+ # @param [String] fields
2028
+ # Selector specifying which fields to include in a partial response.
2029
+ # @param [String] quota_user
2030
+ # Available to use for quota purposes for server-side applications. Can be any
2031
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2032
+ # @param [Google::Apis::RequestOptions] options
2033
+ # Request-specific options
2034
+ #
2035
+ # @yield [result, err] Result & error if block supplied
2036
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] parsed result object
2037
+ # @yieldparam err [StandardError] error object if request failed
2038
+ #
2039
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::FilterSet]
2040
+ #
2041
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2042
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2043
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2044
+ def create_bidder_filter_set(owner_name, filter_set_object = nil, is_transient: nil, fields: nil, quota_user: nil, options: nil, &block)
2045
+ command = make_simple_command(:post, 'v2beta1/{+ownerName}/filterSets', options)
2046
+ command.request_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
2047
+ command.request_object = filter_set_object
2048
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
2049
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::FilterSet
2050
+ command.params['ownerName'] = owner_name unless owner_name.nil?
2051
+ command.query['isTransient'] = is_transient unless is_transient.nil?
2052
+ command.query['fields'] = fields unless fields.nil?
2053
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2054
+ execute_or_queue_command(command, &block)
2055
+ end
2056
+
2057
+ # Deletes the requested filter set from the account with the given account ID.
2058
+ # @param [String] name
2059
+ # Full name of the resource to delete. For example: - For a bidder-level filter
2060
+ # set for bidder 123: `bidders/123/filterSets/abc` - For an account-level filter
2061
+ # set for the buyer account representing bidder 123: `bidders/123/accounts/123/
2062
+ # filterSets/abc` - For an account-level filter set for the child seat buyer
2063
+ # account 456 whose bidder is 123: `bidders/123/accounts/456/filterSets/abc`
2064
+ # @param [String] fields
2065
+ # Selector specifying which fields to include in a partial response.
2066
+ # @param [String] quota_user
2067
+ # Available to use for quota purposes for server-side applications. Can be any
2068
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2069
+ # @param [Google::Apis::RequestOptions] options
2070
+ # Request-specific options
2071
+ #
2072
+ # @yield [result, err] Result & error if block supplied
2073
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::Empty] parsed result object
2074
+ # @yieldparam err [StandardError] error object if request failed
2075
+ #
2076
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::Empty]
2077
+ #
2078
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2079
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2080
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2081
+ def delete_bidder_filter_set(name, fields: nil, quota_user: nil, options: nil, &block)
2082
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
2083
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::Empty::Representation
2084
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::Empty
2085
+ command.params['name'] = name unless name.nil?
2086
+ command.query['fields'] = fields unless fields.nil?
2087
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2088
+ execute_or_queue_command(command, &block)
2089
+ end
2090
+
2091
+ # Retrieves the requested filter set for the account with the given account ID.
2092
+ # @param [String] name
2093
+ # Full name of the resource being requested. For example: - For a bidder-level
2094
+ # filter set for bidder 123: `bidders/123/filterSets/abc` - For an account-level
2095
+ # filter set for the buyer account representing bidder 123: `bidders/123/
2096
+ # accounts/123/filterSets/abc` - For an account-level filter set for the child
2097
+ # seat buyer account 456 whose bidder is 123: `bidders/123/accounts/456/
2098
+ # filterSets/abc`
2099
+ # @param [String] fields
2100
+ # Selector specifying which fields to include in a partial response.
2101
+ # @param [String] quota_user
2102
+ # Available to use for quota purposes for server-side applications. Can be any
2103
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2104
+ # @param [Google::Apis::RequestOptions] options
2105
+ # Request-specific options
2106
+ #
2107
+ # @yield [result, err] Result & error if block supplied
2108
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::FilterSet] parsed result object
2109
+ # @yieldparam err [StandardError] error object if request failed
2110
+ #
2111
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::FilterSet]
2112
+ #
2113
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2114
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2115
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2116
+ def get_bidder_filter_set(name, fields: nil, quota_user: nil, options: nil, &block)
2117
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
2118
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::FilterSet::Representation
2119
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::FilterSet
2120
+ command.params['name'] = name unless name.nil?
2121
+ command.query['fields'] = fields unless fields.nil?
2122
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2123
+ execute_or_queue_command(command, &block)
2124
+ end
2125
+
2126
+ # Lists all filter sets for the account with the given account ID.
2127
+ # @param [String] owner_name
2128
+ # Name of the owner (bidder or account) of the filter sets to be listed. For
2129
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123` - For
2130
+ # an account-level filter set for the buyer account representing bidder 123: `
2131
+ # bidders/123/accounts/123` - For an account-level filter set for the child seat
2132
+ # buyer account 456 whose bidder is 123: `bidders/123/accounts/456`
2133
+ # @param [Fixnum] page_size
2134
+ # Requested page size. The server may return fewer results than requested. If
2135
+ # unspecified, the server will pick an appropriate default.
2136
+ # @param [String] page_token
2137
+ # A token identifying a page of results the server should return. Typically,
2138
+ # this is the value of ListFilterSetsResponse.nextPageToken returned from the
2139
+ # previous call to the accounts.filterSets.list method.
2140
+ # @param [String] fields
2141
+ # Selector specifying which fields to include in a partial response.
2142
+ # @param [String] quota_user
2143
+ # Available to use for quota purposes for server-side applications. Can be any
2144
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2145
+ # @param [Google::Apis::RequestOptions] options
2146
+ # Request-specific options
2147
+ #
2148
+ # @yield [result, err] Result & error if block supplied
2149
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse] parsed result object
2150
+ # @yieldparam err [StandardError] error object if request failed
2151
+ #
2152
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse]
2153
+ #
2154
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2155
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2156
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2157
+ def list_bidder_filter_sets(owner_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2158
+ command = make_simple_command(:get, 'v2beta1/{+ownerName}/filterSets', options)
2159
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse::Representation
2160
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilterSetsResponse
2161
+ command.params['ownerName'] = owner_name unless owner_name.nil?
2162
+ command.query['pageSize'] = page_size unless page_size.nil?
2163
+ command.query['pageToken'] = page_token unless page_token.nil?
2164
+ command.query['fields'] = fields unless fields.nil?
2165
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2166
+ execute_or_queue_command(command, &block)
2167
+ end
2168
+
2169
+ # Lists all metrics that are measured in terms of number of bids.
2170
+ # @param [String] filter_set_name
2171
+ # Name of the filter set that should be applied to the requested metrics. For
2172
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2173
+ # filterSets/abc` - For an account-level filter set for the buyer account
2174
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2175
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2176
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2177
+ # @param [Fixnum] page_size
2178
+ # Requested page size. The server may return fewer results than requested. If
2179
+ # unspecified, the server will pick an appropriate default.
2180
+ # @param [String] page_token
2181
+ # A token identifying a page of results the server should return. Typically,
2182
+ # this is the value of ListBidMetricsResponse.nextPageToken returned from the
2183
+ # previous call to the bidMetrics.list method.
2184
+ # @param [String] fields
2185
+ # Selector specifying which fields to include in a partial response.
2186
+ # @param [String] quota_user
2187
+ # Available to use for quota purposes for server-side applications. Can be any
2188
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2189
+ # @param [Google::Apis::RequestOptions] options
2190
+ # Request-specific options
2191
+ #
2192
+ # @yield [result, err] Result & error if block supplied
2193
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse] parsed result object
2194
+ # @yieldparam err [StandardError] error object if request failed
2195
+ #
2196
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse]
2197
+ #
2198
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2199
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2200
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2201
+ def list_bidder_filter_set_bid_metrics(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2202
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidMetrics', options)
2203
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse::Representation
2204
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidMetricsResponse
2205
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2206
+ command.query['pageSize'] = page_size unless page_size.nil?
2207
+ command.query['pageToken'] = page_token unless page_token.nil?
2208
+ command.query['fields'] = fields unless fields.nil?
2209
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2210
+ execute_or_queue_command(command, &block)
2211
+ end
2212
+
2213
+ # List all errors that occurred in bid responses, with the number of bid
2214
+ # responses affected for each reason.
2215
+ # @param [String] filter_set_name
2216
+ # Name of the filter set that should be applied to the requested metrics. For
2217
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2218
+ # filterSets/abc` - For an account-level filter set for the buyer account
2219
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2220
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2221
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2222
+ # @param [Fixnum] page_size
2223
+ # Requested page size. The server may return fewer results than requested. If
2224
+ # unspecified, the server will pick an appropriate default.
2225
+ # @param [String] page_token
2226
+ # A token identifying a page of results the server should return. Typically,
2227
+ # this is the value of ListBidResponseErrorsResponse.nextPageToken returned from
2228
+ # the previous call to the bidResponseErrors.list method.
2229
+ # @param [String] fields
2230
+ # Selector specifying which fields to include in a partial response.
2231
+ # @param [String] quota_user
2232
+ # Available to use for quota purposes for server-side applications. Can be any
2233
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2234
+ # @param [Google::Apis::RequestOptions] options
2235
+ # Request-specific options
2236
+ #
2237
+ # @yield [result, err] Result & error if block supplied
2238
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse] parsed result object
2239
+ # @yieldparam err [StandardError] error object if request failed
2240
+ #
2241
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse]
2242
+ #
2243
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2244
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2245
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2246
+ def list_bidder_filter_set_bid_response_errors(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2247
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidResponseErrors', options)
2248
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse::Representation
2249
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponseErrorsResponse
2250
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2251
+ command.query['pageSize'] = page_size unless page_size.nil?
2252
+ command.query['pageToken'] = page_token unless page_token.nil?
2253
+ command.query['fields'] = fields unless fields.nil?
2254
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2255
+ execute_or_queue_command(command, &block)
2256
+ end
2257
+
2258
+ # List all reasons for which bid responses were considered to have no applicable
2259
+ # bids, with the number of bid responses affected for each reason.
2260
+ # @param [String] filter_set_name
2261
+ # Name of the filter set that should be applied to the requested metrics. For
2262
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2263
+ # filterSets/abc` - For an account-level filter set for the buyer account
2264
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2265
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2266
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2267
+ # @param [Fixnum] page_size
2268
+ # Requested page size. The server may return fewer results than requested. If
2269
+ # unspecified, the server will pick an appropriate default.
2270
+ # @param [String] page_token
2271
+ # A token identifying a page of results the server should return. Typically,
2272
+ # this is the value of ListBidResponsesWithoutBidsResponse.nextPageToken
2273
+ # returned from the previous call to the bidResponsesWithoutBids.list method.
2274
+ # @param [String] fields
2275
+ # Selector specifying which fields to include in a partial response.
2276
+ # @param [String] quota_user
2277
+ # Available to use for quota purposes for server-side applications. Can be any
2278
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2279
+ # @param [Google::Apis::RequestOptions] options
2280
+ # Request-specific options
2281
+ #
2282
+ # @yield [result, err] Result & error if block supplied
2283
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse] parsed result object
2284
+ # @yieldparam err [StandardError] error object if request failed
2285
+ #
2286
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse]
2287
+ #
2288
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2289
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2290
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2291
+ def list_bidder_filter_set_bid_responses_without_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2292
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/bidResponsesWithoutBids', options)
2293
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse::Representation
2294
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListBidResponsesWithoutBidsResponse
2295
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2296
+ command.query['pageSize'] = page_size unless page_size.nil?
2297
+ command.query['pageToken'] = page_token unless page_token.nil?
2298
+ command.query['fields'] = fields unless fields.nil?
2299
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2300
+ execute_or_queue_command(command, &block)
2301
+ end
2302
+
2303
+ # List all reasons that caused a bid request not to be sent for an impression,
2304
+ # with the number of bid requests not sent for each reason.
2305
+ # @param [String] filter_set_name
2306
+ # Name of the filter set that should be applied to the requested metrics. For
2307
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2308
+ # filterSets/abc` - For an account-level filter set for the buyer account
2309
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2310
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2311
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2312
+ # @param [Fixnum] page_size
2313
+ # Requested page size. The server may return fewer results than requested. If
2314
+ # unspecified, the server will pick an appropriate default.
2315
+ # @param [String] page_token
2316
+ # A token identifying a page of results the server should return. Typically,
2317
+ # this is the value of ListFilteredBidRequestsResponse.nextPageToken returned
2318
+ # from the previous call to the filteredBidRequests.list method.
2319
+ # @param [String] fields
2320
+ # Selector specifying which fields to include in a partial response.
2321
+ # @param [String] quota_user
2322
+ # Available to use for quota purposes for server-side applications. Can be any
2323
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2324
+ # @param [Google::Apis::RequestOptions] options
2325
+ # Request-specific options
2326
+ #
2327
+ # @yield [result, err] Result & error if block supplied
2328
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse] parsed result object
2329
+ # @yieldparam err [StandardError] error object if request failed
2330
+ #
2331
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse]
2332
+ #
2333
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2334
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2335
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2336
+ def list_bidder_filter_set_filtered_bid_requests(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2337
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBidRequests', options)
2338
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse::Representation
2339
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidRequestsResponse
2340
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2341
+ command.query['pageSize'] = page_size unless page_size.nil?
2342
+ command.query['pageToken'] = page_token unless page_token.nil?
2343
+ command.query['fields'] = fields unless fields.nil?
2344
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2345
+ execute_or_queue_command(command, &block)
2346
+ end
2347
+
2348
+ # List all reasons for which bids were filtered, with the number of bids
2349
+ # filtered for each reason.
2350
+ # @param [String] filter_set_name
2351
+ # Name of the filter set that should be applied to the requested metrics. For
2352
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2353
+ # filterSets/abc` - For an account-level filter set for the buyer account
2354
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2355
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2356
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2357
+ # @param [Fixnum] page_size
2358
+ # Requested page size. The server may return fewer results than requested. If
2359
+ # unspecified, the server will pick an appropriate default.
2360
+ # @param [String] page_token
2361
+ # A token identifying a page of results the server should return. Typically,
2362
+ # this is the value of ListFilteredBidsResponse.nextPageToken returned from the
2363
+ # previous call to the filteredBids.list method.
2364
+ # @param [String] fields
2365
+ # Selector specifying which fields to include in a partial response.
2366
+ # @param [String] quota_user
2367
+ # Available to use for quota purposes for server-side applications. Can be any
2368
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2369
+ # @param [Google::Apis::RequestOptions] options
2370
+ # Request-specific options
2371
+ #
2372
+ # @yield [result, err] Result & error if block supplied
2373
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse] parsed result object
2374
+ # @yieldparam err [StandardError] error object if request failed
2375
+ #
2376
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse]
2377
+ #
2378
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2379
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2380
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2381
+ def list_bidder_filter_set_filtered_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2382
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids', options)
2383
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse::Representation
2384
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListFilteredBidsResponse
2385
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2386
+ command.query['pageSize'] = page_size unless page_size.nil?
2387
+ command.query['pageToken'] = page_token unless page_token.nil?
2388
+ command.query['fields'] = fields unless fields.nil?
2389
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2390
+ execute_or_queue_command(command, &block)
2391
+ end
2392
+
2393
+ # List all creatives associated with a specific reason for which bids were
2394
+ # filtered, with the number of bids filtered for each creative.
2395
+ # @param [String] filter_set_name
2396
+ # Name of the filter set that should be applied to the requested metrics. For
2397
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2398
+ # filterSets/abc` - For an account-level filter set for the buyer account
2399
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2400
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2401
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2402
+ # @param [Fixnum] creative_status_id
2403
+ # The ID of the creative status for which to retrieve a breakdown by creative.
2404
+ # See [creative-status-codes](https://developers.google.com/authorized-buyers/
2405
+ # rtb/downloads/creative-status-codes).
2406
+ # @param [Fixnum] page_size
2407
+ # Requested page size. The server may return fewer results than requested. If
2408
+ # unspecified, the server will pick an appropriate default.
2409
+ # @param [String] page_token
2410
+ # A token identifying a page of results the server should return. Typically,
2411
+ # this is the value of ListCreativeStatusBreakdownByCreativeResponse.
2412
+ # nextPageToken returned from the previous call to the filteredBids.creatives.
2413
+ # list method.
2414
+ # @param [String] fields
2415
+ # Selector specifying which fields to include in a partial response.
2416
+ # @param [String] quota_user
2417
+ # Available to use for quota purposes for server-side applications. Can be any
2418
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2419
+ # @param [Google::Apis::RequestOptions] options
2420
+ # Request-specific options
2421
+ #
2422
+ # @yield [result, err] Result & error if block supplied
2423
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse] parsed result object
2424
+ # @yieldparam err [StandardError] error object if request failed
2425
+ #
2426
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse]
2427
+ #
2428
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2429
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2430
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2431
+ def list_bidder_filter_set_filtered_bid_creatives(filter_set_name, creative_status_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2432
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/creatives', options)
2433
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse::Representation
2434
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByCreativeResponse
2435
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2436
+ command.params['creativeStatusId'] = creative_status_id unless creative_status_id.nil?
2437
+ command.query['pageSize'] = page_size unless page_size.nil?
2438
+ command.query['pageToken'] = page_token unless page_token.nil?
2439
+ command.query['fields'] = fields unless fields.nil?
2440
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2441
+ execute_or_queue_command(command, &block)
2442
+ end
2443
+
2444
+ # List all details associated with a specific reason for which bids were
2445
+ # filtered, with the number of bids filtered for each detail.
2446
+ # @param [String] filter_set_name
2447
+ # Name of the filter set that should be applied to the requested metrics. For
2448
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2449
+ # filterSets/abc` - For an account-level filter set for the buyer account
2450
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2451
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2452
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2453
+ # @param [Fixnum] creative_status_id
2454
+ # The ID of the creative status for which to retrieve a breakdown by detail. See
2455
+ # [creative-status-codes](https://developers.google.com/authorized-buyers/rtb/
2456
+ # downloads/creative-status-codes). Details are only available for statuses 10,
2457
+ # 14, 15, 17, 18, 19, 86, and 87.
2458
+ # @param [Fixnum] page_size
2459
+ # Requested page size. The server may return fewer results than requested. If
2460
+ # unspecified, the server will pick an appropriate default.
2461
+ # @param [String] page_token
2462
+ # A token identifying a page of results the server should return. Typically,
2463
+ # this is the value of ListCreativeStatusBreakdownByDetailResponse.nextPageToken
2464
+ # returned from the previous call to the filteredBids.details.list method.
2465
+ # @param [String] fields
2466
+ # Selector specifying which fields to include in a partial response.
2467
+ # @param [String] quota_user
2468
+ # Available to use for quota purposes for server-side applications. Can be any
2469
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2470
+ # @param [Google::Apis::RequestOptions] options
2471
+ # Request-specific options
2472
+ #
2473
+ # @yield [result, err] Result & error if block supplied
2474
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse] parsed result object
2475
+ # @yieldparam err [StandardError] error object if request failed
2476
+ #
2477
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse]
2478
+ #
2479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2482
+ def list_bidder_filter_set_filtered_bid_details(filter_set_name, creative_status_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2483
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/filteredBids/{creativeStatusId}/details', options)
2484
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse::Representation
2485
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListCreativeStatusBreakdownByDetailResponse
2486
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2487
+ command.params['creativeStatusId'] = creative_status_id unless creative_status_id.nil?
2488
+ command.query['pageSize'] = page_size unless page_size.nil?
2489
+ command.query['pageToken'] = page_token unless page_token.nil?
2490
+ command.query['fields'] = fields unless fields.nil?
2491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2492
+ execute_or_queue_command(command, &block)
2493
+ end
2494
+
2495
+ # Lists all metrics that are measured in terms of number of impressions.
2496
+ # @param [String] filter_set_name
2497
+ # Name of the filter set that should be applied to the requested metrics. For
2498
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2499
+ # filterSets/abc` - For an account-level filter set for the buyer account
2500
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2501
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2502
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2503
+ # @param [Fixnum] page_size
2504
+ # Requested page size. The server may return fewer results than requested. If
2505
+ # unspecified, the server will pick an appropriate default.
2506
+ # @param [String] page_token
2507
+ # A token identifying a page of results the server should return. Typically,
2508
+ # this is the value of ListImpressionMetricsResponse.nextPageToken returned from
2509
+ # the previous call to the impressionMetrics.list method.
2510
+ # @param [String] fields
2511
+ # Selector specifying which fields to include in a partial response.
2512
+ # @param [String] quota_user
2513
+ # Available to use for quota purposes for server-side applications. Can be any
2514
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2515
+ # @param [Google::Apis::RequestOptions] options
2516
+ # Request-specific options
2517
+ #
2518
+ # @yield [result, err] Result & error if block supplied
2519
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse] parsed result object
2520
+ # @yieldparam err [StandardError] error object if request failed
2521
+ #
2522
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse]
2523
+ #
2524
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2525
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2526
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2527
+ def list_bidder_filter_set_impression_metrics(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2528
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/impressionMetrics', options)
2529
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse::Representation
2530
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListImpressionMetricsResponse
2531
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2532
+ command.query['pageSize'] = page_size unless page_size.nil?
2533
+ command.query['pageToken'] = page_token unless page_token.nil?
2534
+ command.query['fields'] = fields unless fields.nil?
2535
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2536
+ execute_or_queue_command(command, &block)
2537
+ end
2538
+
2539
+ # List all reasons for which bids lost in the auction, with the number of bids
2540
+ # that lost for each reason.
2541
+ # @param [String] filter_set_name
2542
+ # Name of the filter set that should be applied to the requested metrics. For
2543
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2544
+ # filterSets/abc` - For an account-level filter set for the buyer account
2545
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2546
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2547
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2548
+ # @param [Fixnum] page_size
2549
+ # Requested page size. The server may return fewer results than requested. If
2550
+ # unspecified, the server will pick an appropriate default.
2551
+ # @param [String] page_token
2552
+ # A token identifying a page of results the server should return. Typically,
2553
+ # this is the value of ListLosingBidsResponse.nextPageToken returned from the
2554
+ # previous call to the losingBids.list method.
2555
+ # @param [String] fields
2556
+ # Selector specifying which fields to include in a partial response.
2557
+ # @param [String] quota_user
2558
+ # Available to use for quota purposes for server-side applications. Can be any
2559
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2560
+ # @param [Google::Apis::RequestOptions] options
2561
+ # Request-specific options
2562
+ #
2563
+ # @yield [result, err] Result & error if block supplied
2564
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse] parsed result object
2565
+ # @yieldparam err [StandardError] error object if request failed
2566
+ #
2567
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse]
2568
+ #
2569
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2570
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2571
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2572
+ def list_bidder_filter_set_losing_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2573
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/losingBids', options)
2574
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse::Representation
2575
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListLosingBidsResponse
2576
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2577
+ command.query['pageSize'] = page_size unless page_size.nil?
2578
+ command.query['pageToken'] = page_token unless page_token.nil?
2579
+ command.query['fields'] = fields unless fields.nil?
2580
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2581
+ execute_or_queue_command(command, &block)
2582
+ end
2583
+
2584
+ # List all reasons for which winning bids were not billable, with the number of
2585
+ # bids not billed for each reason.
2586
+ # @param [String] filter_set_name
2587
+ # Name of the filter set that should be applied to the requested metrics. For
2588
+ # example: - For a bidder-level filter set for bidder 123: `bidders/123/
2589
+ # filterSets/abc` - For an account-level filter set for the buyer account
2590
+ # representing bidder 123: `bidders/123/accounts/123/filterSets/abc` - For an
2591
+ # account-level filter set for the child seat buyer account 456 whose bidder is
2592
+ # 123: `bidders/123/accounts/456/filterSets/abc`
2593
+ # @param [Fixnum] page_size
2594
+ # Requested page size. The server may return fewer results than requested. If
2595
+ # unspecified, the server will pick an appropriate default.
2596
+ # @param [String] page_token
2597
+ # A token identifying a page of results the server should return. Typically,
2598
+ # this is the value of ListNonBillableWinningBidsResponse.nextPageToken returned
2599
+ # from the previous call to the nonBillableWinningBids.list method.
2600
+ # @param [String] fields
2601
+ # Selector specifying which fields to include in a partial response.
2602
+ # @param [String] quota_user
2603
+ # Available to use for quota purposes for server-side applications. Can be any
2604
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2605
+ # @param [Google::Apis::RequestOptions] options
2606
+ # Request-specific options
2607
+ #
2608
+ # @yield [result, err] Result & error if block supplied
2609
+ # @yieldparam result [Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse] parsed result object
2610
+ # @yieldparam err [StandardError] error object if request failed
2611
+ #
2612
+ # @return [Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse]
2613
+ #
2614
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2615
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2616
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2617
+ def list_bidder_filter_set_non_billable_winning_bids(filter_set_name, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2618
+ command = make_simple_command(:get, 'v2beta1/{+filterSetName}/nonBillableWinningBids', options)
2619
+ command.response_representation = Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse::Representation
2620
+ command.response_class = Google::Apis::Adexchangebuyer2V2beta1::ListNonBillableWinningBidsResponse
2621
+ command.params['filterSetName'] = filter_set_name unless filter_set_name.nil?
2622
+ command.query['pageSize'] = page_size unless page_size.nil?
2623
+ command.query['pageToken'] = page_token unless page_token.nil?
2624
+ command.query['fields'] = fields unless fields.nil?
2625
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2626
+ execute_or_queue_command(command, &block)
2627
+ end
2628
+
2629
+ protected
2630
+
2631
+ def apply_command_defaults(command)
2632
+ command.query['key'] = key unless key.nil?
2633
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2634
+ end
2635
+ end
2636
+ end
2637
+ end
2638
+ end