google-apis-authorizedbuyersmarketplace_v1alpha 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1828 @@
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 AuthorizedbuyersmarketplaceV1alpha
23
+ # Authorized Buyers Marketplace API
24
+ #
25
+ # The Authorized Buyers Marketplace API lets buyers programmatically discover
26
+ # inventory; propose, retrieve and negotiate deals with publishers.
27
+ #
28
+ # @example
29
+ # require 'google/apis/authorizedbuyersmarketplace_v1alpha'
30
+ #
31
+ # Authorizedbuyersmarketplace = Google::Apis::AuthorizedbuyersmarketplaceV1alpha # Alias the module
32
+ # service = Authorizedbuyersmarketplace::AuthorizedBuyersMarketplaceService.new
33
+ #
34
+ # @see https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/
35
+ class AuthorizedBuyersMarketplaceService < Google::Apis::Core::BaseService
36
+ DEFAULT_ENDPOINT_TEMPLATE = "https://authorizedbuyersmarketplace.$UNIVERSE_DOMAIN$/"
37
+
38
+ # @return [String]
39
+ # API key. Your API key identifies your project and provides you with API access,
40
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
41
+ attr_accessor :key
42
+
43
+ # @return [String]
44
+ # Available to use for quota purposes for server-side applications. Can be any
45
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
46
+ attr_accessor :quota_user
47
+
48
+ def initialize
49
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
50
+ client_name: 'google-apis-authorizedbuyersmarketplace_v1alpha',
51
+ client_version: Google::Apis::AuthorizedbuyersmarketplaceV1alpha::GEM_VERSION)
52
+ @batch_path = 'batch'
53
+ end
54
+
55
+ # List the auction packages. Buyers can use the URL path "/v1alpha/buyers/`
56
+ # accountId`/auctionPackages" to list auction packages for the current buyer and
57
+ # its clients. Bidders can use the URL path "/v1alpha/bidders/`accountId`/
58
+ # auctionPackages" to list auction packages for the bidder, its media planners,
59
+ # its buyers, and all their clients.
60
+ # @param [String] parent
61
+ # Required. Name of the parent buyer that can access the auction package. Format:
62
+ # `buyers/`accountId``. When used with a bidder account, the auction packages
63
+ # that the bidder, its media planners, its buyers and clients are subscribed to
64
+ # will be listed, in the format `bidders/`accountId``.
65
+ # @param [String] filter
66
+ # Optional. Optional query string using the [Cloud API list filtering syntax](/
67
+ # authorized-buyers/apis/guides/list-filters). Only supported when parent is
68
+ # bidder. Supported columns for filtering are: * displayName * createTime *
69
+ # updateTime * eligibleSeatIds
70
+ # @param [String] order_by
71
+ # Optional. An optional query string to sort auction packages using the [Cloud
72
+ # API sorting syntax](https://cloud.google.com/apis/design/design_patterns#
73
+ # sorting_order). If no sort order is specified, results will be returned in an
74
+ # arbitrary order. Only supported when parent is bidder. Supported columns for
75
+ # sorting are: * displayName * createTime * updateTime
76
+ # @param [Fixnum] page_size
77
+ # Requested page size. The server may return fewer results than requested. Max
78
+ # allowed page size is 500.
79
+ # @param [String] page_token
80
+ # The page token as returned. ListAuctionPackagesResponse.nextPageToken
81
+ # @param [String] fields
82
+ # Selector specifying which fields to include in a partial response.
83
+ # @param [String] quota_user
84
+ # Available to use for quota purposes for server-side applications. Can be any
85
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
86
+ # @param [Google::Apis::RequestOptions] options
87
+ # Request-specific options
88
+ #
89
+ # @yield [result, err] Result & error if block supplied
90
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse] parsed result object
91
+ # @yieldparam err [StandardError] error object if request failed
92
+ #
93
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse]
94
+ #
95
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
96
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
97
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
98
+ def list_bidder_auction_packages(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
99
+ command = make_simple_command(:get, 'v1alpha/{+parent}/auctionPackages', options)
100
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse::Representation
101
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse
102
+ command.params['parent'] = parent unless parent.nil?
103
+ command.query['filter'] = filter unless filter.nil?
104
+ command.query['orderBy'] = order_by unless order_by.nil?
105
+ command.query['pageSize'] = page_size unless page_size.nil?
106
+ command.query['pageToken'] = page_token unless page_token.nil?
107
+ command.query['fields'] = fields unless fields.nil?
108
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
109
+ execute_or_queue_command(command, &block)
110
+ end
111
+
112
+ # Lists finalized deals. Use the URL path "/v1alpha/buyers/`accountId`/
113
+ # finalizedDeals" to list finalized deals for the current buyer and its clients.
114
+ # Bidders can use the URL path "/v1alpha/bidders/`accountId`/finalizedDeals" to
115
+ # list finalized deals for the bidder, its buyers and all their clients.
116
+ # @param [String] parent
117
+ # Required. The buyer to list the finalized deals for, in the format: `buyers/`
118
+ # accountId``. When used to list finalized deals for a bidder, its buyers and
119
+ # clients, in the format `bidders/`accountId``.
120
+ # @param [String] filter
121
+ # Optional query string using the [Cloud API list filtering syntax](https://
122
+ # developers.google.com/authorized-buyers/apis/guides/list-filters) Supported
123
+ # columns for filtering are: * deal.displayName * deal.dealType * deal.
124
+ # createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime *
125
+ # deal.eligibleSeatIds * dealServingStatus
126
+ # @param [String] order_by
127
+ # An optional query string to sort finalized deals using the [Cloud API sorting
128
+ # syntax](https://cloud.google.com/apis/design/design_patterns#sorting_order).
129
+ # If no sort order is specified, results will be returned in an arbitrary order.
130
+ # Supported columns for sorting are: * deal.displayName * deal.createTime * deal.
131
+ # updateTime * deal.flightStartTime * deal.flightEndTime * rtbMetrics.
132
+ # bidRequests7Days * rtbMetrics.bids7Days * rtbMetrics.adImpressions7Days *
133
+ # rtbMetrics.bidRate7Days * rtbMetrics.filteredBidRate7Days * rtbMetrics.
134
+ # mustBidRateCurrentMonth
135
+ # @param [Fixnum] page_size
136
+ # Requested page size. The server may return fewer results than requested. If
137
+ # requested more than 500, the server will return 500 results per page. If
138
+ # unspecified, the server will pick a default page size of 100.
139
+ # @param [String] page_token
140
+ # The page token as returned from ListFinalizedDealsResponse.
141
+ # @param [String] fields
142
+ # Selector specifying which fields to include in a partial response.
143
+ # @param [String] quota_user
144
+ # Available to use for quota purposes for server-side applications. Can be any
145
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
146
+ # @param [Google::Apis::RequestOptions] options
147
+ # Request-specific options
148
+ #
149
+ # @yield [result, err] Result & error if block supplied
150
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse] parsed result object
151
+ # @yieldparam err [StandardError] error object if request failed
152
+ #
153
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse]
154
+ #
155
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
156
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
157
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
158
+ def list_bidder_finalized_deals(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
159
+ command = make_simple_command(:get, 'v1alpha/{+parent}/finalizedDeals', options)
160
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse::Representation
161
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse
162
+ command.params['parent'] = parent unless parent.nil?
163
+ command.query['filter'] = filter unless filter.nil?
164
+ command.query['orderBy'] = order_by unless order_by.nil?
165
+ command.query['pageSize'] = page_size unless page_size.nil?
166
+ command.query['pageToken'] = page_token unless page_token.nil?
167
+ command.query['fields'] = fields unless fields.nil?
168
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
169
+ execute_or_queue_command(command, &block)
170
+ end
171
+
172
+ # Gets an auction package given its name.
173
+ # @param [String] name
174
+ # Required. Name of auction package to get. Format: `buyers/`accountId`/
175
+ # auctionPackages/`auctionPackageId``
176
+ # @param [String] fields
177
+ # Selector specifying which fields to include in a partial response.
178
+ # @param [String] quota_user
179
+ # Available to use for quota purposes for server-side applications. Can be any
180
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
181
+ # @param [Google::Apis::RequestOptions] options
182
+ # Request-specific options
183
+ #
184
+ # @yield [result, err] Result & error if block supplied
185
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage] parsed result object
186
+ # @yieldparam err [StandardError] error object if request failed
187
+ #
188
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage]
189
+ #
190
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
191
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
192
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
193
+ def get_buyer_auction_package(name, fields: nil, quota_user: nil, options: nil, &block)
194
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
195
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage::Representation
196
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage
197
+ command.params['name'] = name unless name.nil?
198
+ command.query['fields'] = fields unless fields.nil?
199
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
200
+ execute_or_queue_command(command, &block)
201
+ end
202
+
203
+ # List the auction packages. Buyers can use the URL path "/v1alpha/buyers/`
204
+ # accountId`/auctionPackages" to list auction packages for the current buyer and
205
+ # its clients. Bidders can use the URL path "/v1alpha/bidders/`accountId`/
206
+ # auctionPackages" to list auction packages for the bidder, its media planners,
207
+ # its buyers, and all their clients.
208
+ # @param [String] parent
209
+ # Required. Name of the parent buyer that can access the auction package. Format:
210
+ # `buyers/`accountId``. When used with a bidder account, the auction packages
211
+ # that the bidder, its media planners, its buyers and clients are subscribed to
212
+ # will be listed, in the format `bidders/`accountId``.
213
+ # @param [String] filter
214
+ # Optional. Optional query string using the [Cloud API list filtering syntax](/
215
+ # authorized-buyers/apis/guides/list-filters). Only supported when parent is
216
+ # bidder. Supported columns for filtering are: * displayName * createTime *
217
+ # updateTime * eligibleSeatIds
218
+ # @param [String] order_by
219
+ # Optional. An optional query string to sort auction packages using the [Cloud
220
+ # API sorting syntax](https://cloud.google.com/apis/design/design_patterns#
221
+ # sorting_order). If no sort order is specified, results will be returned in an
222
+ # arbitrary order. Only supported when parent is bidder. Supported columns for
223
+ # sorting are: * displayName * createTime * updateTime
224
+ # @param [Fixnum] page_size
225
+ # Requested page size. The server may return fewer results than requested. Max
226
+ # allowed page size is 500.
227
+ # @param [String] page_token
228
+ # The page token as returned. ListAuctionPackagesResponse.nextPageToken
229
+ # @param [String] fields
230
+ # Selector specifying which fields to include in a partial response.
231
+ # @param [String] quota_user
232
+ # Available to use for quota purposes for server-side applications. Can be any
233
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
234
+ # @param [Google::Apis::RequestOptions] options
235
+ # Request-specific options
236
+ #
237
+ # @yield [result, err] Result & error if block supplied
238
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse] parsed result object
239
+ # @yieldparam err [StandardError] error object if request failed
240
+ #
241
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse]
242
+ #
243
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
244
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
245
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
246
+ def list_buyer_auction_packages(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
247
+ command = make_simple_command(:get, 'v1alpha/{+parent}/auctionPackages', options)
248
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse::Representation
249
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListAuctionPackagesResponse
250
+ command.params['parent'] = parent unless parent.nil?
251
+ command.query['filter'] = filter unless filter.nil?
252
+ command.query['orderBy'] = order_by unless order_by.nil?
253
+ command.query['pageSize'] = page_size unless page_size.nil?
254
+ command.query['pageToken'] = page_token unless page_token.nil?
255
+ command.query['fields'] = fields unless fields.nil?
256
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
257
+ execute_or_queue_command(command, &block)
258
+ end
259
+
260
+ # Subscribe to the auction package for the specified buyer. Once subscribed, the
261
+ # bidder will receive a call out for inventory matching the auction package
262
+ # targeting criteria with the auction package deal ID and the specified buyer.
263
+ # @param [String] name
264
+ # Required. Name of the auction package. Format: `buyers/`accountId`/
265
+ # auctionPackages/`auctionPackageId``
266
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SubscribeAuctionPackageRequest] subscribe_auction_package_request_object
267
+ # @param [String] fields
268
+ # Selector specifying which fields to include in a partial response.
269
+ # @param [String] quota_user
270
+ # Available to use for quota purposes for server-side applications. Can be any
271
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
272
+ # @param [Google::Apis::RequestOptions] options
273
+ # Request-specific options
274
+ #
275
+ # @yield [result, err] Result & error if block supplied
276
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage] parsed result object
277
+ # @yieldparam err [StandardError] error object if request failed
278
+ #
279
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage]
280
+ #
281
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
282
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
283
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
284
+ def subscribe_auction_package(name, subscribe_auction_package_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
285
+ command = make_simple_command(:post, 'v1alpha/{+name}:subscribe', options)
286
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SubscribeAuctionPackageRequest::Representation
287
+ command.request_object = subscribe_auction_package_request_object
288
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage::Representation
289
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage
290
+ command.params['name'] = name unless name.nil?
291
+ command.query['fields'] = fields unless fields.nil?
292
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
293
+ execute_or_queue_command(command, &block)
294
+ end
295
+
296
+ # Subscribe the specified clients of the buyer to the auction package. If a
297
+ # client in the list does not belong to the buyer, an error response will be
298
+ # returned, and all of the following clients in the list will not be subscribed.
299
+ # Subscribing an already subscribed client will have no effect.
300
+ # @param [String] auction_package
301
+ # Required. Name of the auction package. Format: `buyers/`accountId`/
302
+ # auctionPackages/`auctionPackageId``
303
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SubscribeClientsRequest] subscribe_clients_request_object
304
+ # @param [String] fields
305
+ # Selector specifying which fields to include in a partial response.
306
+ # @param [String] quota_user
307
+ # Available to use for quota purposes for server-side applications. Can be any
308
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
309
+ # @param [Google::Apis::RequestOptions] options
310
+ # Request-specific options
311
+ #
312
+ # @yield [result, err] Result & error if block supplied
313
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage] parsed result object
314
+ # @yieldparam err [StandardError] error object if request failed
315
+ #
316
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage]
317
+ #
318
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
319
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
320
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
321
+ def subscribe_auction_package_clients(auction_package, subscribe_clients_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
322
+ command = make_simple_command(:post, 'v1alpha/{+auctionPackage}:subscribeClients', options)
323
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SubscribeClientsRequest::Representation
324
+ command.request_object = subscribe_clients_request_object
325
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage::Representation
326
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage
327
+ command.params['auctionPackage'] = auction_package unless auction_package.nil?
328
+ command.query['fields'] = fields unless fields.nil?
329
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
330
+ execute_or_queue_command(command, &block)
331
+ end
332
+
333
+ # Unsubscribe from the auction package for the specified buyer. Once
334
+ # unsubscribed, the bidder will no longer receive a call out for the auction
335
+ # package deal ID and the specified buyer.
336
+ # @param [String] name
337
+ # Required. Name of the auction package. Format: `buyers/`accountId`/
338
+ # auctionPackages/`auctionPackageId``
339
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::UnsubscribeAuctionPackageRequest] unsubscribe_auction_package_request_object
340
+ # @param [String] fields
341
+ # Selector specifying which fields to include in a partial response.
342
+ # @param [String] quota_user
343
+ # Available to use for quota purposes for server-side applications. Can be any
344
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
345
+ # @param [Google::Apis::RequestOptions] options
346
+ # Request-specific options
347
+ #
348
+ # @yield [result, err] Result & error if block supplied
349
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage] parsed result object
350
+ # @yieldparam err [StandardError] error object if request failed
351
+ #
352
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage]
353
+ #
354
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
355
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
356
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
357
+ def unsubscribe_auction_package(name, unsubscribe_auction_package_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
358
+ command = make_simple_command(:post, 'v1alpha/{+name}:unsubscribe', options)
359
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::UnsubscribeAuctionPackageRequest::Representation
360
+ command.request_object = unsubscribe_auction_package_request_object
361
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage::Representation
362
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage
363
+ command.params['name'] = name unless name.nil?
364
+ command.query['fields'] = fields unless fields.nil?
365
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
366
+ execute_or_queue_command(command, &block)
367
+ end
368
+
369
+ # Unsubscribe from the auction package for the specified clients of the buyer.
370
+ # Unsubscribing a client that is not subscribed will have no effect.
371
+ # @param [String] auction_package
372
+ # Required. Name of the auction package. Format: `buyers/`accountId`/
373
+ # auctionPackages/`auctionPackageId``
374
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::UnsubscribeClientsRequest] unsubscribe_clients_request_object
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::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage] parsed result object
385
+ # @yieldparam err [StandardError] error object if request failed
386
+ #
387
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage]
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 unsubscribe_auction_package_clients(auction_package, unsubscribe_clients_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
393
+ command = make_simple_command(:post, 'v1alpha/{+auctionPackage}:unsubscribeClients', options)
394
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::UnsubscribeClientsRequest::Representation
395
+ command.request_object = unsubscribe_clients_request_object
396
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage::Representation
397
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AuctionPackage
398
+ command.params['auctionPackage'] = auction_package unless auction_package.nil?
399
+ command.query['fields'] = fields unless fields.nil?
400
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
401
+ execute_or_queue_command(command, &block)
402
+ end
403
+
404
+ # Activates an existing client. The state of the client will be updated to "
405
+ # ACTIVE". This method has no effect if the client is already in "ACTIVE" state.
406
+ # @param [String] name
407
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId``
408
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateClientRequest] activate_client_request_object
409
+ # @param [String] fields
410
+ # Selector specifying which fields to include in a partial response.
411
+ # @param [String] quota_user
412
+ # Available to use for quota purposes for server-side applications. Can be any
413
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
414
+ # @param [Google::Apis::RequestOptions] options
415
+ # Request-specific options
416
+ #
417
+ # @yield [result, err] Result & error if block supplied
418
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] parsed result object
419
+ # @yieldparam err [StandardError] error object if request failed
420
+ #
421
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client]
422
+ #
423
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
424
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
425
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
426
+ def activate_client(name, activate_client_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
427
+ command = make_simple_command(:post, 'v1alpha/{+name}:activate', options)
428
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateClientRequest::Representation
429
+ command.request_object = activate_client_request_object
430
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
431
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client
432
+ command.params['name'] = name unless name.nil?
433
+ command.query['fields'] = fields unless fields.nil?
434
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
435
+ execute_or_queue_command(command, &block)
436
+ end
437
+
438
+ # Creates a new client.
439
+ # @param [String] parent
440
+ # Required. The name of the buyer. Format: `buyers/`accountId``
441
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] client_object
442
+ # @param [String] fields
443
+ # Selector specifying which fields to include in a partial response.
444
+ # @param [String] quota_user
445
+ # Available to use for quota purposes for server-side applications. Can be any
446
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
447
+ # @param [Google::Apis::RequestOptions] options
448
+ # Request-specific options
449
+ #
450
+ # @yield [result, err] Result & error if block supplied
451
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] parsed result object
452
+ # @yieldparam err [StandardError] error object if request failed
453
+ #
454
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client]
455
+ #
456
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
457
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
458
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
459
+ def create_buyer_client(parent, client_object = nil, fields: nil, quota_user: nil, options: nil, &block)
460
+ command = make_simple_command(:post, 'v1alpha/{+parent}/clients', options)
461
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
462
+ command.request_object = client_object
463
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
464
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client
465
+ command.params['parent'] = parent unless parent.nil?
466
+ command.query['fields'] = fields unless fields.nil?
467
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
468
+ execute_or_queue_command(command, &block)
469
+ end
470
+
471
+ # Deactivates an existing client. The state of the client will be updated to "
472
+ # INACTIVE". This method has no effect if the client is already in "INACTIVE"
473
+ # state.
474
+ # @param [String] name
475
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId``
476
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateClientRequest] deactivate_client_request_object
477
+ # @param [String] fields
478
+ # Selector specifying which fields to include in a partial response.
479
+ # @param [String] quota_user
480
+ # Available to use for quota purposes for server-side applications. Can be any
481
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
482
+ # @param [Google::Apis::RequestOptions] options
483
+ # Request-specific options
484
+ #
485
+ # @yield [result, err] Result & error if block supplied
486
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] parsed result object
487
+ # @yieldparam err [StandardError] error object if request failed
488
+ #
489
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client]
490
+ #
491
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
492
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
493
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
494
+ def deactivate_client(name, deactivate_client_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
495
+ command = make_simple_command(:post, 'v1alpha/{+name}:deactivate', options)
496
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateClientRequest::Representation
497
+ command.request_object = deactivate_client_request_object
498
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
499
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client
500
+ command.params['name'] = name unless name.nil?
501
+ command.query['fields'] = fields unless fields.nil?
502
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
503
+ execute_or_queue_command(command, &block)
504
+ end
505
+
506
+ # Gets a client with a given resource name.
507
+ # @param [String] name
508
+ # Required. Format: `buyers/`accountId`/clients/`clientAccountId``
509
+ # @param [String] fields
510
+ # Selector specifying which fields to include in a partial response.
511
+ # @param [String] quota_user
512
+ # Available to use for quota purposes for server-side applications. Can be any
513
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
514
+ # @param [Google::Apis::RequestOptions] options
515
+ # Request-specific options
516
+ #
517
+ # @yield [result, err] Result & error if block supplied
518
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] parsed result object
519
+ # @yieldparam err [StandardError] error object if request failed
520
+ #
521
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client]
522
+ #
523
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
524
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
525
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
526
+ def get_buyer_client(name, fields: nil, quota_user: nil, options: nil, &block)
527
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
528
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
529
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client
530
+ command.params['name'] = name unless name.nil?
531
+ command.query['fields'] = fields unless fields.nil?
532
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
533
+ execute_or_queue_command(command, &block)
534
+ end
535
+
536
+ # Lists all the clients for the current buyer.
537
+ # @param [String] parent
538
+ # Required. The name of the buyer. Format: `buyers/`accountId``
539
+ # @param [String] filter
540
+ # Query string using the [Filtering Syntax](https://developers.google.com/
541
+ # authorized-buyers/apis/guides/list-filters) Supported fields for filtering are:
542
+ # * partnerClientId Use this field to filter the clients by the partnerClientId.
543
+ # For example, if the partnerClientId of the client is "1234", the value of
544
+ # this field should be `partnerClientId = "1234"`, in order to get only the
545
+ # client whose partnerClientId is "1234" in the response.
546
+ # @param [Fixnum] page_size
547
+ # Requested page size. If left blank, a default page size of 500 will be applied.
548
+ # @param [String] page_token
549
+ # A token identifying a page of results the server should return. Typically,
550
+ # this is the value of ListClientsResponse.nextPageToken returned from the
551
+ # previous call to the list method.
552
+ # @param [String] fields
553
+ # Selector specifying which fields to include in a partial response.
554
+ # @param [String] quota_user
555
+ # Available to use for quota purposes for server-side applications. Can be any
556
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
557
+ # @param [Google::Apis::RequestOptions] options
558
+ # Request-specific options
559
+ #
560
+ # @yield [result, err] Result & error if block supplied
561
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientsResponse] parsed result object
562
+ # @yieldparam err [StandardError] error object if request failed
563
+ #
564
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientsResponse]
565
+ #
566
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
567
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
568
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
569
+ def list_buyer_clients(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
570
+ command = make_simple_command(:get, 'v1alpha/{+parent}/clients', options)
571
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientsResponse::Representation
572
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientsResponse
573
+ command.params['parent'] = parent unless parent.nil?
574
+ command.query['filter'] = filter unless filter.nil?
575
+ command.query['pageSize'] = page_size unless page_size.nil?
576
+ command.query['pageToken'] = page_token unless page_token.nil?
577
+ command.query['fields'] = fields unless fields.nil?
578
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
579
+ execute_or_queue_command(command, &block)
580
+ end
581
+
582
+ # Updates an existing client.
583
+ # @param [String] name
584
+ # Output only. The resource name of the client. Format: `buyers/`accountId`/
585
+ # clients/`clientAccountId``
586
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] client_object
587
+ # @param [String] update_mask
588
+ # List of fields to be updated. If empty or unspecified, the service will update
589
+ # all fields populated in the update request excluding the output only fields
590
+ # and primitive fields with default value. Note that explicit field mask is
591
+ # required in order to reset a primitive field back to its default value, for
592
+ # example, false for boolean fields, 0 for integer fields. A special field mask
593
+ # consisting of a single path "*" can be used to indicate full replacement(the
594
+ # equivalent of PUT method), updatable fields unset or unspecified in the input
595
+ # will be cleared or set to default value. Output only fields will be ignored
596
+ # regardless of the value of updateMask.
597
+ # @param [String] fields
598
+ # Selector specifying which fields to include in a partial response.
599
+ # @param [String] quota_user
600
+ # Available to use for quota purposes for server-side applications. Can be any
601
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
602
+ # @param [Google::Apis::RequestOptions] options
603
+ # Request-specific options
604
+ #
605
+ # @yield [result, err] Result & error if block supplied
606
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client] parsed result object
607
+ # @yieldparam err [StandardError] error object if request failed
608
+ #
609
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client]
610
+ #
611
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
612
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
613
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
614
+ def patch_buyer_client(name, client_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
615
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
616
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
617
+ command.request_object = client_object
618
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client::Representation
619
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Client
620
+ command.params['name'] = name unless name.nil?
621
+ command.query['updateMask'] = update_mask unless update_mask.nil?
622
+ command.query['fields'] = fields unless fields.nil?
623
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
624
+ execute_or_queue_command(command, &block)
625
+ end
626
+
627
+ # Activates an existing client user. The state of the client user will be
628
+ # updated from "INACTIVE" to "ACTIVE". This method has no effect if the client
629
+ # user is already in "ACTIVE" state. An error will be returned if the client
630
+ # user to activate is still in "INVITED" state.
631
+ # @param [String] name
632
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId`/
633
+ # clientUsers/`userId``
634
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateClientUserRequest] activate_client_user_request_object
635
+ # @param [String] fields
636
+ # Selector specifying which fields to include in a partial response.
637
+ # @param [String] quota_user
638
+ # Available to use for quota purposes for server-side applications. Can be any
639
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
640
+ # @param [Google::Apis::RequestOptions] options
641
+ # Request-specific options
642
+ #
643
+ # @yield [result, err] Result & error if block supplied
644
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser] parsed result object
645
+ # @yieldparam err [StandardError] error object if request failed
646
+ #
647
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser]
648
+ #
649
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
650
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
651
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
652
+ def activate_client_user(name, activate_client_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
653
+ command = make_simple_command(:post, 'v1alpha/{+name}:activate', options)
654
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateClientUserRequest::Representation
655
+ command.request_object = activate_client_user_request_object
656
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser::Representation
657
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser
658
+ command.params['name'] = name unless name.nil?
659
+ command.query['fields'] = fields unless fields.nil?
660
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
661
+ execute_or_queue_command(command, &block)
662
+ end
663
+
664
+ # Creates a new client user in "INVITED" state. An email invitation will be sent
665
+ # to the new user, once accepted the user will become active.
666
+ # @param [String] parent
667
+ # Required. The name of the client. Format: `buyers/`accountId`/clients/`
668
+ # clientAccountId``
669
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser] client_user_object
670
+ # @param [String] fields
671
+ # Selector specifying which fields to include in a partial response.
672
+ # @param [String] quota_user
673
+ # Available to use for quota purposes for server-side applications. Can be any
674
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
675
+ # @param [Google::Apis::RequestOptions] options
676
+ # Request-specific options
677
+ #
678
+ # @yield [result, err] Result & error if block supplied
679
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser] parsed result object
680
+ # @yieldparam err [StandardError] error object if request failed
681
+ #
682
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser]
683
+ #
684
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
685
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
686
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
687
+ def create_buyer_client_user(parent, client_user_object = nil, fields: nil, quota_user: nil, options: nil, &block)
688
+ command = make_simple_command(:post, 'v1alpha/{+parent}/users', options)
689
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser::Representation
690
+ command.request_object = client_user_object
691
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser::Representation
692
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser
693
+ command.params['parent'] = parent unless parent.nil?
694
+ command.query['fields'] = fields unless fields.nil?
695
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
696
+ execute_or_queue_command(command, &block)
697
+ end
698
+
699
+ # Deactivates an existing client user. The state of the client user will be
700
+ # updated from "ACTIVE" to "INACTIVE". This method has no effect if the client
701
+ # user is already in "INACTIVE" state. An error will be returned if the client
702
+ # user to deactivate is still in "INVITED" state.
703
+ # @param [String] name
704
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId`/
705
+ # clientUsers/`userId``
706
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateClientUserRequest] deactivate_client_user_request_object
707
+ # @param [String] fields
708
+ # Selector specifying which fields to include in a partial response.
709
+ # @param [String] quota_user
710
+ # Available to use for quota purposes for server-side applications. Can be any
711
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
712
+ # @param [Google::Apis::RequestOptions] options
713
+ # Request-specific options
714
+ #
715
+ # @yield [result, err] Result & error if block supplied
716
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser] parsed result object
717
+ # @yieldparam err [StandardError] error object if request failed
718
+ #
719
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser]
720
+ #
721
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
722
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
723
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
724
+ def deactivate_client_user(name, deactivate_client_user_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
725
+ command = make_simple_command(:post, 'v1alpha/{+name}:deactivate', options)
726
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateClientUserRequest::Representation
727
+ command.request_object = deactivate_client_user_request_object
728
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser::Representation
729
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser
730
+ command.params['name'] = name unless name.nil?
731
+ command.query['fields'] = fields unless fields.nil?
732
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
733
+ execute_or_queue_command(command, &block)
734
+ end
735
+
736
+ # Deletes an existing client user. The client user will lose access to the
737
+ # Authorized Buyers UI. Note that if a client user is deleted, the user's access
738
+ # to the UI can't be restored unless a new client user is created and activated.
739
+ # @param [String] name
740
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId`/
741
+ # clientUsers/`userId``
742
+ # @param [String] fields
743
+ # Selector specifying which fields to include in a partial response.
744
+ # @param [String] quota_user
745
+ # Available to use for quota purposes for server-side applications. Can be any
746
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
747
+ # @param [Google::Apis::RequestOptions] options
748
+ # Request-specific options
749
+ #
750
+ # @yield [result, err] Result & error if block supplied
751
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Empty] parsed result object
752
+ # @yieldparam err [StandardError] error object if request failed
753
+ #
754
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Empty]
755
+ #
756
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
757
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
758
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
759
+ def delete_buyer_client_user(name, fields: nil, quota_user: nil, options: nil, &block)
760
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
761
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Empty::Representation
762
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Empty
763
+ command.params['name'] = name unless name.nil?
764
+ command.query['fields'] = fields unless fields.nil?
765
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
766
+ execute_or_queue_command(command, &block)
767
+ end
768
+
769
+ # Retrieves an existing client user.
770
+ # @param [String] name
771
+ # Required. Format: `buyers/`buyerAccountId`/clients/`clientAccountId`/
772
+ # clientUsers/`userId``
773
+ # @param [String] fields
774
+ # Selector specifying which fields to include in a partial response.
775
+ # @param [String] quota_user
776
+ # Available to use for quota purposes for server-side applications. Can be any
777
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
778
+ # @param [Google::Apis::RequestOptions] options
779
+ # Request-specific options
780
+ #
781
+ # @yield [result, err] Result & error if block supplied
782
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser] parsed result object
783
+ # @yieldparam err [StandardError] error object if request failed
784
+ #
785
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser]
786
+ #
787
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
788
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
789
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
790
+ def get_buyer_client_user(name, fields: nil, quota_user: nil, options: nil, &block)
791
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
792
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser::Representation
793
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ClientUser
794
+ command.params['name'] = name unless name.nil?
795
+ command.query['fields'] = fields unless fields.nil?
796
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
797
+ execute_or_queue_command(command, &block)
798
+ end
799
+
800
+ # Lists all client users for a specified client.
801
+ # @param [String] parent
802
+ # Required. The name of the client. Format: `buyers/`buyerAccountId`/clients/`
803
+ # clientAccountId``
804
+ # @param [Fixnum] page_size
805
+ # Requested page size. If left blank, a default page size of 500 will be applied.
806
+ # @param [String] page_token
807
+ # A token identifying a page of results the server should return. Typically,
808
+ # this is the value of ListClientUsersResponse.nextPageToken returned from the
809
+ # previous call to the list method.
810
+ # @param [String] fields
811
+ # Selector specifying which fields to include in a partial response.
812
+ # @param [String] quota_user
813
+ # Available to use for quota purposes for server-side applications. Can be any
814
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
815
+ # @param [Google::Apis::RequestOptions] options
816
+ # Request-specific options
817
+ #
818
+ # @yield [result, err] Result & error if block supplied
819
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientUsersResponse] parsed result object
820
+ # @yieldparam err [StandardError] error object if request failed
821
+ #
822
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientUsersResponse]
823
+ #
824
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
825
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
826
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
827
+ def list_buyer_client_users(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
828
+ command = make_simple_command(:get, 'v1alpha/{+parent}/users', options)
829
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientUsersResponse::Representation
830
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListClientUsersResponse
831
+ command.params['parent'] = parent unless parent.nil?
832
+ command.query['pageSize'] = page_size unless page_size.nil?
833
+ command.query['pageToken'] = page_token unless page_token.nil?
834
+ command.query['fields'] = fields unless fields.nil?
835
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
836
+ execute_or_queue_command(command, &block)
837
+ end
838
+
839
+ # Activates a data segment.
840
+ # @param [String] name
841
+ # Required. Name of data segment to activate. Format: `buyers/`accountId`/
842
+ # dataSegments/`curatorDataSegmentId``
843
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateDataSegmentRequest] activate_data_segment_request_object
844
+ # @param [String] fields
845
+ # Selector specifying which fields to include in a partial response.
846
+ # @param [String] quota_user
847
+ # Available to use for quota purposes for server-side applications. Can be any
848
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
849
+ # @param [Google::Apis::RequestOptions] options
850
+ # Request-specific options
851
+ #
852
+ # @yield [result, err] Result & error if block supplied
853
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] parsed result object
854
+ # @yieldparam err [StandardError] error object if request failed
855
+ #
856
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment]
857
+ #
858
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
859
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
860
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
861
+ def activate_data_segment(name, activate_data_segment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
862
+ command = make_simple_command(:post, 'v1alpha/{+name}:activate', options)
863
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ActivateDataSegmentRequest::Representation
864
+ command.request_object = activate_data_segment_request_object
865
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
866
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment
867
+ command.params['name'] = name unless name.nil?
868
+ command.query['fields'] = fields unless fields.nil?
869
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
870
+ execute_or_queue_command(command, &block)
871
+ end
872
+
873
+ # Creates a data segment owned by the listed curator. The data segment will be
874
+ # created in the `ACTIVE` state, meaning it will be immediately available for
875
+ # buyers to use in preferred deals, private auction deals, and auction packages.
876
+ # @param [String] parent
877
+ # Required. The parent resource where this data segment will be created. Format:
878
+ # `buyers/`accountId``
879
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] data_segment_object
880
+ # @param [String] fields
881
+ # Selector specifying which fields to include in a partial response.
882
+ # @param [String] quota_user
883
+ # Available to use for quota purposes for server-side applications. Can be any
884
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
885
+ # @param [Google::Apis::RequestOptions] options
886
+ # Request-specific options
887
+ #
888
+ # @yield [result, err] Result & error if block supplied
889
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] parsed result object
890
+ # @yieldparam err [StandardError] error object if request failed
891
+ #
892
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment]
893
+ #
894
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
895
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
896
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
897
+ def create_buyer_data_segment(parent, data_segment_object = nil, fields: nil, quota_user: nil, options: nil, &block)
898
+ command = make_simple_command(:post, 'v1alpha/{+parent}/dataSegments', options)
899
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
900
+ command.request_object = data_segment_object
901
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
902
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment
903
+ command.params['parent'] = parent unless parent.nil?
904
+ command.query['fields'] = fields unless fields.nil?
905
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
906
+ execute_or_queue_command(command, &block)
907
+ end
908
+
909
+ # Deactivates a data segment.
910
+ # @param [String] name
911
+ # Required. Name of data segment to deactivate. Format: `buyers/`accountId`/
912
+ # dataSegments/`curatorDataSegmentId``
913
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateDataSegmentRequest] deactivate_data_segment_request_object
914
+ # @param [String] fields
915
+ # Selector specifying which fields to include in a partial response.
916
+ # @param [String] quota_user
917
+ # Available to use for quota purposes for server-side applications. Can be any
918
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
919
+ # @param [Google::Apis::RequestOptions] options
920
+ # Request-specific options
921
+ #
922
+ # @yield [result, err] Result & error if block supplied
923
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] parsed result object
924
+ # @yieldparam err [StandardError] error object if request failed
925
+ #
926
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment]
927
+ #
928
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
929
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
930
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
931
+ def deactivate_data_segment(name, deactivate_data_segment_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
932
+ command = make_simple_command(:post, 'v1alpha/{+name}:deactivate', options)
933
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DeactivateDataSegmentRequest::Representation
934
+ command.request_object = deactivate_data_segment_request_object
935
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
936
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment
937
+ command.params['name'] = name unless name.nil?
938
+ command.query['fields'] = fields unless fields.nil?
939
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
940
+ execute_or_queue_command(command, &block)
941
+ end
942
+
943
+ # Gets a data segment given its name.
944
+ # @param [String] name
945
+ # Required. Name of data segment to get. Format: `buyers/`accountId`/
946
+ # dataSegments/`curatorDataSegmentId``
947
+ # @param [String] fields
948
+ # Selector specifying which fields to include in a partial response.
949
+ # @param [String] quota_user
950
+ # Available to use for quota purposes for server-side applications. Can be any
951
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
952
+ # @param [Google::Apis::RequestOptions] options
953
+ # Request-specific options
954
+ #
955
+ # @yield [result, err] Result & error if block supplied
956
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] parsed result object
957
+ # @yieldparam err [StandardError] error object if request failed
958
+ #
959
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment]
960
+ #
961
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
962
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
963
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
964
+ def get_buyer_data_segment(name, fields: nil, quota_user: nil, options: nil, &block)
965
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
966
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
967
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment
968
+ command.params['name'] = name unless name.nil?
969
+ command.query['fields'] = fields unless fields.nil?
970
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
971
+ execute_or_queue_command(command, &block)
972
+ end
973
+
974
+ # List the data segments owned by a curator.
975
+ # @param [String] parent
976
+ # Required. Name of the parent buyer that can access the data segment. Format: `
977
+ # buyers/`accountId``
978
+ # @param [Fixnum] page_size
979
+ # Optional. Requested page size. The server may return fewer results than
980
+ # requested. Max allowed page size is 500. If unspecified, the server will
981
+ # default to 500.
982
+ # @param [String] page_token
983
+ # Optional. The page token as returned. ListDataSegmentsResponse.nextPageToken
984
+ # @param [String] fields
985
+ # Selector specifying which fields to include in a partial response.
986
+ # @param [String] quota_user
987
+ # Available to use for quota purposes for server-side applications. Can be any
988
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
989
+ # @param [Google::Apis::RequestOptions] options
990
+ # Request-specific options
991
+ #
992
+ # @yield [result, err] Result & error if block supplied
993
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDataSegmentsResponse] parsed result object
994
+ # @yieldparam err [StandardError] error object if request failed
995
+ #
996
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDataSegmentsResponse]
997
+ #
998
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
999
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1000
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1001
+ def list_buyer_data_segments(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1002
+ command = make_simple_command(:get, 'v1alpha/{+parent}/dataSegments', options)
1003
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDataSegmentsResponse::Representation
1004
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDataSegmentsResponse
1005
+ command.params['parent'] = parent unless parent.nil?
1006
+ command.query['pageSize'] = page_size unless page_size.nil?
1007
+ command.query['pageToken'] = page_token unless page_token.nil?
1008
+ command.query['fields'] = fields unless fields.nil?
1009
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1010
+ execute_or_queue_command(command, &block)
1011
+ end
1012
+
1013
+ # Updates a data segment.
1014
+ # @param [String] name
1015
+ # Immutable. Identifier. The unique identifier for the data segment. Account ID
1016
+ # corresponds to the account ID that created the segment. Format: `buyers/`
1017
+ # accountId`/dataSegments/`curatorDataSegmentId``
1018
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] data_segment_object
1019
+ # @param [String] update_mask
1020
+ # Optional. List of fields to be updated. If empty or unspecified, the service
1021
+ # will update all fields populated in the update request excluding the output
1022
+ # only fields and primitive fields with default value. Note that explicit field
1023
+ # mask is required in order to reset a primitive field back to its default value,
1024
+ # for example, false for boolean fields, 0 for integer fields. A special field
1025
+ # mask consisting of a single path "*" can be used to indicate full replacement(
1026
+ # the equivalent of PUT method), updatable fields unset or unspecified in the
1027
+ # input will be cleared or set to default value. Output only fields will be
1028
+ # ignored regardless of the value of updateMask.
1029
+ # @param [String] fields
1030
+ # Selector specifying which fields to include in a partial response.
1031
+ # @param [String] quota_user
1032
+ # Available to use for quota purposes for server-side applications. Can be any
1033
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1034
+ # @param [Google::Apis::RequestOptions] options
1035
+ # Request-specific options
1036
+ #
1037
+ # @yield [result, err] Result & error if block supplied
1038
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment] parsed result object
1039
+ # @yieldparam err [StandardError] error object if request failed
1040
+ #
1041
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment]
1042
+ #
1043
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1044
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1045
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1046
+ def patch_buyer_data_segment(name, data_segment_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1047
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1048
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
1049
+ command.request_object = data_segment_object
1050
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment::Representation
1051
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::DataSegment
1052
+ command.params['name'] = name unless name.nil?
1053
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1054
+ command.query['fields'] = fields unless fields.nil?
1055
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1056
+ execute_or_queue_command(command, &block)
1057
+ end
1058
+
1059
+ # Add creative to be used in the bidding process for a finalized deal. For
1060
+ # programmatic guaranteed deals, it's recommended that you associate at least
1061
+ # one approved creative with the deal before calling SetReadyToServe, to help
1062
+ # reduce the number of bid responses filtered because they don't contain
1063
+ # approved creatives. Creatives successfully added to a deal can be found in the
1064
+ # Realtime-bidding Creatives API creative.deal_ids. This method only applies to
1065
+ # programmatic guaranteed deals. Maximum number of 1000 creatives can be added
1066
+ # to a finalized deal.
1067
+ # @param [String] deal
1068
+ # Required. Name of the finalized deal in the format of: `buyers/`accountId`/
1069
+ # finalizedDeals/`dealId``
1070
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AddCreativeRequest] add_creative_request_object
1071
+ # @param [String] fields
1072
+ # Selector specifying which fields to include in a partial response.
1073
+ # @param [String] quota_user
1074
+ # Available to use for quota purposes for server-side applications. Can be any
1075
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1076
+ # @param [Google::Apis::RequestOptions] options
1077
+ # Request-specific options
1078
+ #
1079
+ # @yield [result, err] Result & error if block supplied
1080
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal] parsed result object
1081
+ # @yieldparam err [StandardError] error object if request failed
1082
+ #
1083
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal]
1084
+ #
1085
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1086
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1087
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1088
+ def add_finalized_deal_creative(deal, add_creative_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1089
+ command = make_simple_command(:post, 'v1alpha/{+deal}:addCreative', options)
1090
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AddCreativeRequest::Representation
1091
+ command.request_object = add_creative_request_object
1092
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal::Representation
1093
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal
1094
+ command.params['deal'] = deal unless deal.nil?
1095
+ command.query['fields'] = fields unless fields.nil?
1096
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1097
+ execute_or_queue_command(command, &block)
1098
+ end
1099
+
1100
+ # Gets a finalized deal given its name.
1101
+ # @param [String] name
1102
+ # Required. Format: `buyers/`accountId`/finalizedDeals/`dealId``
1103
+ # @param [String] fields
1104
+ # Selector specifying which fields to include in a partial response.
1105
+ # @param [String] quota_user
1106
+ # Available to use for quota purposes for server-side applications. Can be any
1107
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1108
+ # @param [Google::Apis::RequestOptions] options
1109
+ # Request-specific options
1110
+ #
1111
+ # @yield [result, err] Result & error if block supplied
1112
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal] parsed result object
1113
+ # @yieldparam err [StandardError] error object if request failed
1114
+ #
1115
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal]
1116
+ #
1117
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1118
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1119
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1120
+ def get_buyer_finalized_deal(name, fields: nil, quota_user: nil, options: nil, &block)
1121
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1122
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal::Representation
1123
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal
1124
+ command.params['name'] = name unless name.nil?
1125
+ command.query['fields'] = fields unless fields.nil?
1126
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1127
+ execute_or_queue_command(command, &block)
1128
+ end
1129
+
1130
+ # Lists finalized deals. Use the URL path "/v1alpha/buyers/`accountId`/
1131
+ # finalizedDeals" to list finalized deals for the current buyer and its clients.
1132
+ # Bidders can use the URL path "/v1alpha/bidders/`accountId`/finalizedDeals" to
1133
+ # list finalized deals for the bidder, its buyers and all their clients.
1134
+ # @param [String] parent
1135
+ # Required. The buyer to list the finalized deals for, in the format: `buyers/`
1136
+ # accountId``. When used to list finalized deals for a bidder, its buyers and
1137
+ # clients, in the format `bidders/`accountId``.
1138
+ # @param [String] filter
1139
+ # Optional query string using the [Cloud API list filtering syntax](https://
1140
+ # developers.google.com/authorized-buyers/apis/guides/list-filters) Supported
1141
+ # columns for filtering are: * deal.displayName * deal.dealType * deal.
1142
+ # createTime * deal.updateTime * deal.flightStartTime * deal.flightEndTime *
1143
+ # deal.eligibleSeatIds * dealServingStatus
1144
+ # @param [String] order_by
1145
+ # An optional query string to sort finalized deals using the [Cloud API sorting
1146
+ # syntax](https://cloud.google.com/apis/design/design_patterns#sorting_order).
1147
+ # If no sort order is specified, results will be returned in an arbitrary order.
1148
+ # Supported columns for sorting are: * deal.displayName * deal.createTime * deal.
1149
+ # updateTime * deal.flightStartTime * deal.flightEndTime * rtbMetrics.
1150
+ # bidRequests7Days * rtbMetrics.bids7Days * rtbMetrics.adImpressions7Days *
1151
+ # rtbMetrics.bidRate7Days * rtbMetrics.filteredBidRate7Days * rtbMetrics.
1152
+ # mustBidRateCurrentMonth
1153
+ # @param [Fixnum] page_size
1154
+ # Requested page size. The server may return fewer results than requested. If
1155
+ # requested more than 500, the server will return 500 results per page. If
1156
+ # unspecified, the server will pick a default page size of 100.
1157
+ # @param [String] page_token
1158
+ # The page token as returned from ListFinalizedDealsResponse.
1159
+ # @param [String] fields
1160
+ # Selector specifying which fields to include in a partial response.
1161
+ # @param [String] quota_user
1162
+ # Available to use for quota purposes for server-side applications. Can be any
1163
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1164
+ # @param [Google::Apis::RequestOptions] options
1165
+ # Request-specific options
1166
+ #
1167
+ # @yield [result, err] Result & error if block supplied
1168
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse] parsed result object
1169
+ # @yieldparam err [StandardError] error object if request failed
1170
+ #
1171
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse]
1172
+ #
1173
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1174
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1175
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1176
+ def list_buyer_finalized_deals(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1177
+ command = make_simple_command(:get, 'v1alpha/{+parent}/finalizedDeals', options)
1178
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse::Representation
1179
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListFinalizedDealsResponse
1180
+ command.params['parent'] = parent unless parent.nil?
1181
+ command.query['filter'] = filter unless filter.nil?
1182
+ command.query['orderBy'] = order_by unless order_by.nil?
1183
+ command.query['pageSize'] = page_size unless page_size.nil?
1184
+ command.query['pageToken'] = page_token unless page_token.nil?
1185
+ command.query['fields'] = fields unless fields.nil?
1186
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1187
+ execute_or_queue_command(command, &block)
1188
+ end
1189
+
1190
+ # Pauses serving of the given finalized deal. This call only pauses the serving
1191
+ # status, and does not affect other fields of the finalized deal. Calling this
1192
+ # method for an already paused deal has no effect. This method only applies to
1193
+ # programmatic guaranteed deals and preferred deals.
1194
+ # @param [String] name
1195
+ # Required. Format: `buyers/`accountId`/finalizedDeals/`dealId``
1196
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PauseFinalizedDealRequest] pause_finalized_deal_request_object
1197
+ # @param [String] fields
1198
+ # Selector specifying which fields to include in a partial response.
1199
+ # @param [String] quota_user
1200
+ # Available to use for quota purposes for server-side applications. Can be any
1201
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1202
+ # @param [Google::Apis::RequestOptions] options
1203
+ # Request-specific options
1204
+ #
1205
+ # @yield [result, err] Result & error if block supplied
1206
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal] parsed result object
1207
+ # @yieldparam err [StandardError] error object if request failed
1208
+ #
1209
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal]
1210
+ #
1211
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1212
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1213
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1214
+ def pause_finalized_deal(name, pause_finalized_deal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1215
+ command = make_simple_command(:post, 'v1alpha/{+name}:pause', options)
1216
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PauseFinalizedDealRequest::Representation
1217
+ command.request_object = pause_finalized_deal_request_object
1218
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal::Representation
1219
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal
1220
+ command.params['name'] = name unless name.nil?
1221
+ command.query['fields'] = fields unless fields.nil?
1222
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1223
+ execute_or_queue_command(command, &block)
1224
+ end
1225
+
1226
+ # Resumes serving of the given finalized deal. Calling this method for an
1227
+ # running deal has no effect. If a deal is initially paused by the seller,
1228
+ # calling this method will not resume serving of the deal until the seller also
1229
+ # resumes the deal. This method only applies to programmatic guaranteed deals
1230
+ # and preferred deals.
1231
+ # @param [String] name
1232
+ # Required. Format: `buyers/`accountId`/finalizedDeals/`dealId``
1233
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ResumeFinalizedDealRequest] resume_finalized_deal_request_object
1234
+ # @param [String] fields
1235
+ # Selector specifying which fields to include in a partial response.
1236
+ # @param [String] quota_user
1237
+ # Available to use for quota purposes for server-side applications. Can be any
1238
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1239
+ # @param [Google::Apis::RequestOptions] options
1240
+ # Request-specific options
1241
+ #
1242
+ # @yield [result, err] Result & error if block supplied
1243
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal] parsed result object
1244
+ # @yieldparam err [StandardError] error object if request failed
1245
+ #
1246
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal]
1247
+ #
1248
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1249
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1250
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1251
+ def resume_finalized_deal(name, resume_finalized_deal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1252
+ command = make_simple_command(:post, 'v1alpha/{+name}:resume', options)
1253
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ResumeFinalizedDealRequest::Representation
1254
+ command.request_object = resume_finalized_deal_request_object
1255
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal::Representation
1256
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal
1257
+ command.params['name'] = name unless name.nil?
1258
+ command.query['fields'] = fields unless fields.nil?
1259
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1260
+ execute_or_queue_command(command, &block)
1261
+ end
1262
+
1263
+ # Sets the given finalized deal as ready to serve. By default, deals are set as
1264
+ # ready to serve as soon as they're finalized. If you want to opt out of the
1265
+ # default behavior, and manually indicate that deals are ready to serve, ask
1266
+ # your Technical Account Manager to add you to the allowlist. If you choose to
1267
+ # use this method, finalized deals belonging to the bidder and its child seats
1268
+ # don't start serving until after you call `setReadyToServe`, and after the
1269
+ # deals become active. For example, you can use this method to delay receiving
1270
+ # bid requests until your creative is ready. This method only applies to
1271
+ # programmatic guaranteed deals.
1272
+ # @param [String] deal
1273
+ # Required. Format: `buyers/`accountId`/finalizedDeals/`dealId``
1274
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SetReadyToServeRequest] set_ready_to_serve_request_object
1275
+ # @param [String] fields
1276
+ # Selector specifying which fields to include in a partial response.
1277
+ # @param [String] quota_user
1278
+ # Available to use for quota purposes for server-side applications. Can be any
1279
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1280
+ # @param [Google::Apis::RequestOptions] options
1281
+ # Request-specific options
1282
+ #
1283
+ # @yield [result, err] Result & error if block supplied
1284
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal] parsed result object
1285
+ # @yieldparam err [StandardError] error object if request failed
1286
+ #
1287
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal]
1288
+ #
1289
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1290
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1291
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1292
+ def set_finalized_deal_ready_to_serve(deal, set_ready_to_serve_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1293
+ command = make_simple_command(:post, 'v1alpha/{+deal}:setReadyToServe', options)
1294
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SetReadyToServeRequest::Representation
1295
+ command.request_object = set_ready_to_serve_request_object
1296
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal::Representation
1297
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::FinalizedDeal
1298
+ command.params['deal'] = deal unless deal.nil?
1299
+ command.query['fields'] = fields unless fields.nil?
1300
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1301
+ execute_or_queue_command(command, &block)
1302
+ end
1303
+
1304
+ # Accepts the proposal at the given revision number. If the revision number in
1305
+ # the request is behind the latest from the server, an error message will be
1306
+ # returned. This call updates the Proposal.state from `
1307
+ # BUYER_ACCEPTANCE_REQUESTED` to `FINALIZED`; it has no side effect if the
1308
+ # Proposal.state is already `FINALIZED` and throws exception if the Proposal.
1309
+ # state is not either `BUYER_ACCEPTANCE_REQUESTED` or `FINALIZED`. Accepting a
1310
+ # proposal means the buyer understands and accepts the Proposal.
1311
+ # terms_and_conditions proposed by the seller.
1312
+ # @param [String] name
1313
+ # Name of the proposal. Format: `buyers/`accountId`/proposals/`proposalId``
1314
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AcceptProposalRequest] accept_proposal_request_object
1315
+ # @param [String] fields
1316
+ # Selector specifying which fields to include in a partial response.
1317
+ # @param [String] quota_user
1318
+ # Available to use for quota purposes for server-side applications. Can be any
1319
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1320
+ # @param [Google::Apis::RequestOptions] options
1321
+ # Request-specific options
1322
+ #
1323
+ # @yield [result, err] Result & error if block supplied
1324
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1325
+ # @yieldparam err [StandardError] error object if request failed
1326
+ #
1327
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1328
+ #
1329
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1330
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1331
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1332
+ def accept_proposal(name, accept_proposal_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1333
+ command = make_simple_command(:post, 'v1alpha/{+name}:accept', options)
1334
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AcceptProposalRequest::Representation
1335
+ command.request_object = accept_proposal_request_object
1336
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1337
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1338
+ command.params['name'] = name unless name.nil?
1339
+ command.query['fields'] = fields unless fields.nil?
1340
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1341
+ execute_or_queue_command(command, &block)
1342
+ end
1343
+
1344
+ # Creates a note for this proposal and sends to the seller. This method is not
1345
+ # supported for proposals with DealType set to 'PRIVATE_AUCTION'.
1346
+ # @param [String] proposal
1347
+ # Name of the proposal. Format: `buyers/`accountId`/proposals/`proposalId``
1348
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AddNoteRequest] add_note_request_object
1349
+ # @param [String] fields
1350
+ # Selector specifying which fields to include in a partial response.
1351
+ # @param [String] quota_user
1352
+ # Available to use for quota purposes for server-side applications. Can be any
1353
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1354
+ # @param [Google::Apis::RequestOptions] options
1355
+ # Request-specific options
1356
+ #
1357
+ # @yield [result, err] Result & error if block supplied
1358
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1359
+ # @yieldparam err [StandardError] error object if request failed
1360
+ #
1361
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1362
+ #
1363
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1364
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1365
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1366
+ def add_proposal_note(proposal, add_note_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1367
+ command = make_simple_command(:post, 'v1alpha/{+proposal}:addNote', options)
1368
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::AddNoteRequest::Representation
1369
+ command.request_object = add_note_request_object
1370
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1371
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1372
+ command.params['proposal'] = proposal unless proposal.nil?
1373
+ command.query['fields'] = fields unless fields.nil?
1374
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1375
+ execute_or_queue_command(command, &block)
1376
+ end
1377
+
1378
+ # Cancels an ongoing negotiation on a proposal. This does not cancel or end
1379
+ # serving for the deals if the proposal has been finalized. If the proposal has
1380
+ # not been finalized before, calling this method will set the Proposal.state to `
1381
+ # TERMINATED` and increment the Proposal.proposal_revision. If the proposal has
1382
+ # been finalized before and is under renegotiation now, calling this method will
1383
+ # reset the Proposal.state to `FINALIZED` and increment the Proposal.
1384
+ # proposal_revision. This method does not support private auction proposals
1385
+ # whose Proposal.deal_type is 'PRIVATE_AUCTION'.
1386
+ # @param [String] proposal
1387
+ # Name of the proposal. Format: `buyers/`accountId`/proposals/`proposalId``
1388
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::CancelNegotiationRequest] cancel_negotiation_request_object
1389
+ # @param [String] fields
1390
+ # Selector specifying which fields to include in a partial response.
1391
+ # @param [String] quota_user
1392
+ # Available to use for quota purposes for server-side applications. Can be any
1393
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1394
+ # @param [Google::Apis::RequestOptions] options
1395
+ # Request-specific options
1396
+ #
1397
+ # @yield [result, err] Result & error if block supplied
1398
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1399
+ # @yieldparam err [StandardError] error object if request failed
1400
+ #
1401
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1402
+ #
1403
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1404
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1405
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1406
+ def cancel_proposal_negotiation(proposal, cancel_negotiation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1407
+ command = make_simple_command(:post, 'v1alpha/{+proposal}:cancelNegotiation', options)
1408
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::CancelNegotiationRequest::Representation
1409
+ command.request_object = cancel_negotiation_request_object
1410
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1411
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1412
+ command.params['proposal'] = proposal unless proposal.nil?
1413
+ command.query['fields'] = fields unless fields.nil?
1414
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1415
+ execute_or_queue_command(command, &block)
1416
+ end
1417
+
1418
+ # Gets a proposal using its resource name. The proposal is returned at the
1419
+ # latest revision.
1420
+ # @param [String] name
1421
+ # Required. Name of the proposal. Format: `buyers/`accountId`/proposals/`
1422
+ # proposalId``
1423
+ # @param [String] fields
1424
+ # Selector specifying which fields to include in a partial response.
1425
+ # @param [String] quota_user
1426
+ # Available to use for quota purposes for server-side applications. Can be any
1427
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1428
+ # @param [Google::Apis::RequestOptions] options
1429
+ # Request-specific options
1430
+ #
1431
+ # @yield [result, err] Result & error if block supplied
1432
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1433
+ # @yieldparam err [StandardError] error object if request failed
1434
+ #
1435
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1436
+ #
1437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1440
+ def get_buyer_proposal(name, fields: nil, quota_user: nil, options: nil, &block)
1441
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1442
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1443
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1444
+ command.params['name'] = name unless name.nil?
1445
+ command.query['fields'] = fields unless fields.nil?
1446
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1447
+ execute_or_queue_command(command, &block)
1448
+ end
1449
+
1450
+ # Lists proposals. A filter expression using [Cloud API list filtering syntax](
1451
+ # https://developers.google.com/authorized-buyers/apis/guides/list-filters) may
1452
+ # be specified to filter the results.
1453
+ # @param [String] parent
1454
+ # Required. Parent that owns the collection of proposals Format: `buyers/`
1455
+ # accountId``
1456
+ # @param [String] filter
1457
+ # Optional query string using the [Cloud API list filtering syntax](https://
1458
+ # developers.google.com/authorized-buyers/apis/guides/list-filters) Supported
1459
+ # columns for filtering are: * displayName * dealType * updateTime * state
1460
+ # @param [Fixnum] page_size
1461
+ # Requested page size. The server may return fewer results than requested. If
1462
+ # unspecified, the server will put a size of 500.
1463
+ # @param [String] page_token
1464
+ # The page token as returned from ListProposalsResponse.
1465
+ # @param [String] fields
1466
+ # Selector specifying which fields to include in a partial response.
1467
+ # @param [String] quota_user
1468
+ # Available to use for quota purposes for server-side applications. Can be any
1469
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1470
+ # @param [Google::Apis::RequestOptions] options
1471
+ # Request-specific options
1472
+ #
1473
+ # @yield [result, err] Result & error if block supplied
1474
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListProposalsResponse] parsed result object
1475
+ # @yieldparam err [StandardError] error object if request failed
1476
+ #
1477
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListProposalsResponse]
1478
+ #
1479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1482
+ def list_buyer_proposals(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1483
+ command = make_simple_command(:get, 'v1alpha/{+parent}/proposals', options)
1484
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListProposalsResponse::Representation
1485
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListProposalsResponse
1486
+ command.params['parent'] = parent unless parent.nil?
1487
+ command.query['filter'] = filter unless filter.nil?
1488
+ command.query['pageSize'] = page_size unless page_size.nil?
1489
+ command.query['pageToken'] = page_token unless page_token.nil?
1490
+ command.query['fields'] = fields unless fields.nil?
1491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1492
+ execute_or_queue_command(command, &block)
1493
+ end
1494
+
1495
+ # Updates the proposal at the given revision number. If the revision number in
1496
+ # the request is behind the latest one kept in the server, an error message will
1497
+ # be returned. See FieldMask for how to use FieldMask. Only fields specified in
1498
+ # the UpdateProposalRequest.update_mask will be updated; Fields noted as '
1499
+ # Immutable' or 'Output only' yet specified in the UpdateProposalRequest.
1500
+ # update_mask will be ignored and left unchanged. Updating a private auction
1501
+ # proposal is not allowed and will result in an error.
1502
+ # @param [String] name
1503
+ # Immutable. The name of the proposal serving as a unique identifier. Format:
1504
+ # buyers/`accountId`/proposals/`proposalId`
1505
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] proposal_object
1506
+ # @param [String] update_mask
1507
+ # List of fields to be updated. If empty or unspecified, the service will update
1508
+ # all fields populated in the update request excluding the output only fields
1509
+ # and primitive fields with default value. Note that explicit field mask is
1510
+ # required in order to reset a primitive field back to its default value, for
1511
+ # example, false for boolean fields, 0 for integer fields. A special field mask
1512
+ # consisting of a single path "*" can be used to indicate full replacement(the
1513
+ # equivalent of PUT method), updatable fields unset or unspecified in the input
1514
+ # will be cleared or set to default value. Output only fields will be ignored
1515
+ # regardless of the value of updateMask.
1516
+ # @param [String] fields
1517
+ # Selector specifying which fields to include in a partial response.
1518
+ # @param [String] quota_user
1519
+ # Available to use for quota purposes for server-side applications. Can be any
1520
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1521
+ # @param [Google::Apis::RequestOptions] options
1522
+ # Request-specific options
1523
+ #
1524
+ # @yield [result, err] Result & error if block supplied
1525
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1526
+ # @yieldparam err [StandardError] error object if request failed
1527
+ #
1528
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1529
+ #
1530
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1531
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1532
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1533
+ def patch_buyer_proposal(name, proposal_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1534
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1535
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1536
+ command.request_object = proposal_object
1537
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1538
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1539
+ command.params['name'] = name unless name.nil?
1540
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1541
+ command.query['fields'] = fields unless fields.nil?
1542
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1543
+ execute_or_queue_command(command, &block)
1544
+ end
1545
+
1546
+ # Sends a request for proposal (RFP) to a publisher to initiate the negotiation
1547
+ # regarding certain inventory. In the RFP, buyers can specify the deal type,
1548
+ # deal terms, start and end dates, targeting, and a message to the publisher.
1549
+ # Once the RFP is sent, a proposal in `SELLER_REVIEW_REQUESTED` state will be
1550
+ # created and returned in the response. The publisher may review your request
1551
+ # and respond with detailed deals in the proposal.
1552
+ # @param [String] buyer
1553
+ # Required. The current buyer who is sending the RFP in the format: `buyers/`
1554
+ # accountId``.
1555
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SendRfpRequest] send_rfp_request_object
1556
+ # @param [String] fields
1557
+ # Selector specifying which fields to include in a partial response.
1558
+ # @param [String] quota_user
1559
+ # Available to use for quota purposes for server-side applications. Can be any
1560
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1561
+ # @param [Google::Apis::RequestOptions] options
1562
+ # Request-specific options
1563
+ #
1564
+ # @yield [result, err] Result & error if block supplied
1565
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal] parsed result object
1566
+ # @yieldparam err [StandardError] error object if request failed
1567
+ #
1568
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal]
1569
+ #
1570
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1571
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1572
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1573
+ def send_proposal_rfp(buyer, send_rfp_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1574
+ command = make_simple_command(:post, 'v1alpha/{+buyer}/proposals:sendRfp', options)
1575
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::SendRfpRequest::Representation
1576
+ command.request_object = send_rfp_request_object
1577
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal::Representation
1578
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Proposal
1579
+ command.params['buyer'] = buyer unless buyer.nil?
1580
+ command.query['fields'] = fields unless fields.nil?
1581
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1582
+ execute_or_queue_command(command, &block)
1583
+ end
1584
+
1585
+ # Batch updates multiple deals in the same proposal.
1586
+ # @param [String] parent
1587
+ # Required. The name of the proposal containing the deals to batch update.
1588
+ # Format: buyers/`accountId`/proposals/`proposalId`
1589
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsRequest] batch_update_deals_request_object
1590
+ # @param [String] fields
1591
+ # Selector specifying which fields to include in a partial response.
1592
+ # @param [String] quota_user
1593
+ # Available to use for quota purposes for server-side applications. Can be any
1594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1595
+ # @param [Google::Apis::RequestOptions] options
1596
+ # Request-specific options
1597
+ #
1598
+ # @yield [result, err] Result & error if block supplied
1599
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsResponse] parsed result object
1600
+ # @yieldparam err [StandardError] error object if request failed
1601
+ #
1602
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsResponse]
1603
+ #
1604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1607
+ def batch_update_deals(parent, batch_update_deals_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1608
+ command = make_simple_command(:post, 'v1alpha/{+parent}/deals:batchUpdate', options)
1609
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsRequest::Representation
1610
+ command.request_object = batch_update_deals_request_object
1611
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsResponse::Representation
1612
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::BatchUpdateDealsResponse
1613
+ command.params['parent'] = parent unless parent.nil?
1614
+ command.query['fields'] = fields unless fields.nil?
1615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1616
+ execute_or_queue_command(command, &block)
1617
+ end
1618
+
1619
+ # Gets a deal given its name. The deal is returned at its head revision.
1620
+ # @param [String] name
1621
+ # Required. Format: buyers/`accountId`/proposals/`proposalId`/deals/`dealId`
1622
+ # @param [String] fields
1623
+ # Selector specifying which fields to include in a partial response.
1624
+ # @param [String] quota_user
1625
+ # Available to use for quota purposes for server-side applications. Can be any
1626
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1627
+ # @param [Google::Apis::RequestOptions] options
1628
+ # Request-specific options
1629
+ #
1630
+ # @yield [result, err] Result & error if block supplied
1631
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal] parsed result object
1632
+ # @yieldparam err [StandardError] error object if request failed
1633
+ #
1634
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal]
1635
+ #
1636
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1637
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1638
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1639
+ def get_buyer_proposal_deal(name, fields: nil, quota_user: nil, options: nil, &block)
1640
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1641
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal::Representation
1642
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal
1643
+ command.params['name'] = name unless name.nil?
1644
+ command.query['fields'] = fields unless fields.nil?
1645
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1646
+ execute_or_queue_command(command, &block)
1647
+ end
1648
+
1649
+ # Lists all deals in a proposal. To retrieve only the finalized revision deals
1650
+ # regardless if a deal is being renegotiated, see the FinalizedDeals resource.
1651
+ # @param [String] parent
1652
+ # Required. The name of the proposal containing the deals to retrieve. Format:
1653
+ # buyers/`accountId`/proposals/`proposalId`
1654
+ # @param [Fixnum] page_size
1655
+ # Requested page size. The server may return fewer results than requested. If
1656
+ # requested more than 500, the server will return 500 results per page. If
1657
+ # unspecified, the server will pick a default page size of 100.
1658
+ # @param [String] page_token
1659
+ # The page token as returned from ListDealsResponse.
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::AuthorizedbuyersmarketplaceV1alpha::ListDealsResponse] parsed result object
1670
+ # @yieldparam err [StandardError] error object if request failed
1671
+ #
1672
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDealsResponse]
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_buyer_proposal_deals(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1678
+ command = make_simple_command(:get, 'v1alpha/{+parent}/deals', options)
1679
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDealsResponse::Representation
1680
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListDealsResponse
1681
+ command.params['parent'] = parent unless parent.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
+ # Updates the given deal at the buyer known revision number. If the server
1690
+ # revision has advanced since the passed-in proposal.proposal_revision an
1691
+ # ABORTED error message will be returned. The revision number is incremented by
1692
+ # the server whenever the proposal or its constituent deals are updated. Note:
1693
+ # The revision number is kept at a proposal level. The buyer of the API is
1694
+ # expected to keep track of the revision number after the last update operation
1695
+ # and send it in as part of the next update request. This way, if there are
1696
+ # further changes on the server (for example, seller making new updates), then
1697
+ # the server can detect conflicts and reject the proposed changes.
1698
+ # @param [String] name
1699
+ # Immutable. The unique identifier of the deal. Auto-generated by the server
1700
+ # when a deal is created. Format: buyers/`accountId`/proposals/`proposalId`/
1701
+ # deals/`dealId`
1702
+ # @param [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal] deal_object
1703
+ # @param [String] update_mask
1704
+ # List of fields to be updated. If empty or unspecified, the service will update
1705
+ # all fields populated in the update request excluding the output only fields
1706
+ # and primitive fields with default value. Note that explicit field mask is
1707
+ # required in order to reset a primitive field back to its default value, for
1708
+ # example, false for boolean fields, 0 for integer fields. A special field mask
1709
+ # consisting of a single path "*" can be used to indicate full replacement(the
1710
+ # equivalent of PUT method), updatable fields unset or unspecified in the input
1711
+ # will be cleared or set to default value. Output only fields will be ignored
1712
+ # regardless of the value of updateMask.
1713
+ # @param [String] fields
1714
+ # Selector specifying which fields to include in a partial response.
1715
+ # @param [String] quota_user
1716
+ # Available to use for quota purposes for server-side applications. Can be any
1717
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1718
+ # @param [Google::Apis::RequestOptions] options
1719
+ # Request-specific options
1720
+ #
1721
+ # @yield [result, err] Result & error if block supplied
1722
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal] parsed result object
1723
+ # @yieldparam err [StandardError] error object if request failed
1724
+ #
1725
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal]
1726
+ #
1727
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1728
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1729
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1730
+ def patch_buyer_proposal_deal(name, deal_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1731
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1732
+ command.request_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal::Representation
1733
+ command.request_object = deal_object
1734
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal::Representation
1735
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::Deal
1736
+ command.params['name'] = name unless name.nil?
1737
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1738
+ command.query['fields'] = fields unless fields.nil?
1739
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1740
+ execute_or_queue_command(command, &block)
1741
+ end
1742
+
1743
+ # Gets the requested publisher profile by name.
1744
+ # @param [String] name
1745
+ # Required. Name of the publisher profile. Format: `buyers/`buyerId`/
1746
+ # publisherProfiles/`publisherProfileId``
1747
+ # @param [String] fields
1748
+ # Selector specifying which fields to include in a partial response.
1749
+ # @param [String] quota_user
1750
+ # Available to use for quota purposes for server-side applications. Can be any
1751
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1752
+ # @param [Google::Apis::RequestOptions] options
1753
+ # Request-specific options
1754
+ #
1755
+ # @yield [result, err] Result & error if block supplied
1756
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PublisherProfile] parsed result object
1757
+ # @yieldparam err [StandardError] error object if request failed
1758
+ #
1759
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PublisherProfile]
1760
+ #
1761
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1762
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1763
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1764
+ def get_buyer_publisher_profile(name, fields: nil, quota_user: nil, options: nil, &block)
1765
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
1766
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PublisherProfile::Representation
1767
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::PublisherProfile
1768
+ command.params['name'] = name unless name.nil?
1769
+ command.query['fields'] = fields unless fields.nil?
1770
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1771
+ execute_or_queue_command(command, &block)
1772
+ end
1773
+
1774
+ # Lists publisher profiles. The returned publisher profiles aren't in any
1775
+ # defined order. The order of the results might change. A new publisher profile
1776
+ # can appear in any place in the list of returned results.
1777
+ # @param [String] parent
1778
+ # Required. Parent that owns the collection of publisher profiles Format: `
1779
+ # buyers/`buyerId``
1780
+ # @param [String] filter
1781
+ # Optional query string using the [Cloud API list filtering] (https://developers.
1782
+ # google.com/authorized-buyers/apis/guides/list-filters) syntax.
1783
+ # @param [Fixnum] page_size
1784
+ # Requested page size. The server may return fewer results than requested. If
1785
+ # requested more than 500, the server will return 500 results per page. If
1786
+ # unspecified, the server will pick a default page size of 100.
1787
+ # @param [String] page_token
1788
+ # The page token as returned from a previous ListPublisherProfilesResponse.
1789
+ # @param [String] fields
1790
+ # Selector specifying which fields to include in a partial response.
1791
+ # @param [String] quota_user
1792
+ # Available to use for quota purposes for server-side applications. Can be any
1793
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1794
+ # @param [Google::Apis::RequestOptions] options
1795
+ # Request-specific options
1796
+ #
1797
+ # @yield [result, err] Result & error if block supplied
1798
+ # @yieldparam result [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListPublisherProfilesResponse] parsed result object
1799
+ # @yieldparam err [StandardError] error object if request failed
1800
+ #
1801
+ # @return [Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListPublisherProfilesResponse]
1802
+ #
1803
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1804
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1805
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1806
+ def list_buyer_publisher_profiles(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1807
+ command = make_simple_command(:get, 'v1alpha/{+parent}/publisherProfiles', options)
1808
+ command.response_representation = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListPublisherProfilesResponse::Representation
1809
+ command.response_class = Google::Apis::AuthorizedbuyersmarketplaceV1alpha::ListPublisherProfilesResponse
1810
+ command.params['parent'] = parent unless parent.nil?
1811
+ command.query['filter'] = filter unless filter.nil?
1812
+ command.query['pageSize'] = page_size unless page_size.nil?
1813
+ command.query['pageToken'] = page_token unless page_token.nil?
1814
+ command.query['fields'] = fields unless fields.nil?
1815
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1816
+ execute_or_queue_command(command, &block)
1817
+ end
1818
+
1819
+ protected
1820
+
1821
+ def apply_command_defaults(command)
1822
+ command.query['key'] = key unless key.nil?
1823
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1824
+ end
1825
+ end
1826
+ end
1827
+ end
1828
+ end