google-apis-realtimebidding_v1 0.1.0 → 0.30.0

data/lib/google/apis/realtimebidding_v1/service.rb

@@ -52,7 +52,79 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Lists creatives.
+        # Gets a bidder account by its name.
+        # @param [String] name
+        #   Required. Name of the bidder to get. Format: `bidders/`bidderAccountId``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::Bidder] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::Bidder]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_bidder(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::Bidder::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::Bidder
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the bidder accounts that belong to the caller.
+        # @param [Fixnum] page_size
+        #   The maximum number of bidders to return. If unspecified, at most 100 bidders
+        #   will be returned. The maximum value is 500; values above 500 will be coerced
+        #   to 500.
+        # @param [String] page_token
+        #   A token identifying a page of results the server should return. This value is
+        #   received from a previous `ListBidders` call in ListBiddersResponse.
+        #   nextPageToken.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::ListBiddersResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::ListBiddersResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_bidders(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/bidders', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::ListBiddersResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::ListBiddersResponse
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists creatives as they are at the time of the initial request. This call may
+        # take multiple hours to complete. For large, paginated requests, this method
+        # returns a snapshot of creatives at the time of request for the first page. `
+        # lastStatusUpdate` and `creativeServingDecision` may be outdated for creatives
+        # on sequential pages. We recommend [Google Cloud Pub/Sub](//cloud.google.com/
+        # pubsub/docs/overview) to view the latest status.
         # @param [String] parent
         #   Required. Name of the parent buyer that owns the creatives. The pattern for
         #   this resource is either `buyers/`buyerAccountId`` or `bidders/`bidderAccountId`
@@ -63,8 +135,8 @@ module Google
         #   123`), you would use the pattern: `buyers/456`. 3. The ID of the bidder itself.
         #   So for listing creatives pertaining to bidder (`123`), you would use `buyers/
         #   123`. If you want to access all creatives pertaining to both the bidder and
-        #   all of its child seat accounts, you would use `bidders/`bidderAccountId``, e.g.
-        #   , for all creatives pertaining to bidder (`123`), use `bidders/123`.
+        #   all of its child seat accounts, you would use `bidders/`bidderAccountId``, for
+        #   example, for all creatives pertaining to bidder (`123`), use `bidders/123`.
         # @param [String] filter
         #   Query string to filter creatives. If no filter is specified, all active
         #   creatives will be returned. Example: 'accountId=12345 AND (dealsStatus:
@@ -72,13 +144,15 @@ module Google
         #   IS_COOKIE_TARGETED'
         # @param [Fixnum] page_size
         #   Requested page size. The server may return fewer creatives than requested (due
-        #   to timeout constraint) even if more are available via another call. If
+        #   to timeout constraint) even if more are available through another call. If
         #   unspecified, server will pick an appropriate default. Acceptable values are 1
         #   to 1000, inclusive.
         # @param [String] page_token
         #   A token identifying a page of results the server should return. Typically,
         #   this is the value of ListCreativesResponse.nextPageToken returned from the
-        #   previous call to the 'ListCreatives' method.
+        #   previous call to the 'ListCreatives' method. Page tokens for continued pages
+        #   are valid for up to five hours, counting from the call to 'ListCreatives' for
+        #   the first page.
         # @param [String] view
         #   Controls the amount of information included in the response. By default only
         #   creativeServingDecision is included. To retrieve the entire creative resource (
@@ -154,6 +228,117 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a bidder endpoint by its name.
+        # @param [String] name
+        #   Required. Name of the bidder endpoint to get. Format: `bidders/`
+        #   bidderAccountId`/endpoints/`endpointId``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::Endpoint] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::Endpoint]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_bidder_endpoint(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::Endpoint::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::Endpoint
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the bidder's endpoints.
+        # @param [String] parent
+        #   Required. Name of the bidder whose endpoints will be listed. Format: `bidders/`
+        #   bidderAccountId``
+        # @param [Fixnum] page_size
+        #   The maximum number of endpoints to return. If unspecified, at most 100
+        #   endpoints will be returned. The maximum value is 500; values above 500 will be
+        #   coerced to 500.
+        # @param [String] page_token
+        #   A token identifying a page of results the server should return. This value is
+        #   received from a previous `ListEndpoints` call in ListEndpointsResponse.
+        #   nextPageToken.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::ListEndpointsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::ListEndpointsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_bidder_endpoints(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/endpoints', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::ListEndpointsResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::ListEndpointsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a bidder's endpoint.
+        # @param [String] name
+        #   Output only. Name of the endpoint resource that must follow the pattern `
+        #   bidders/`bidderAccountId`/endpoints/`endpointId``, where `bidderAccountId` is
+        #   the account ID of the bidder who operates this endpoint, and `endpointId` is a
+        #   unique ID assigned by the server.
+        # @param [Google::Apis::RealtimebiddingV1::Endpoint] endpoint_object
+        # @param [String] update_mask
+        #   Field mask to use for partial in-place updates.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::Endpoint] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::Endpoint]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_bidder_endpoint(name, endpoint_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::RealtimebiddingV1::Endpoint::Representation
+          command.request_object = endpoint_object
+          command.response_representation = Google::Apis::RealtimebiddingV1::Endpoint::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::Endpoint
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Activates a pretargeting configuration.
         # @param [String] name
         #   Required. The name of the pretargeting configuration. Format: bidders/`
@@ -604,16 +789,207 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets remarketing tag for a buyer. A remarketing tag is a piece of JavaScript
-        # code that can be placed on a web page. When a user visits a page containing a
-        # remarketing tag, Google adds the user to a user list.
+        # Batch approves multiple publisher connections.
+        # @param [String] parent
+        #   Required. The bidder for whom publisher connections will be approved. Format: `
+        #   bidders/`bidder`` where ``bidder`` is the account ID of the bidder.
+        # @param [Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsRequest] batch_approve_publisher_connections_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batch_approve_publisher_connections(parent, batch_approve_publisher_connections_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/publisherConnections:batchApprove', options)
+          command.request_representation = Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsRequest::Representation
+          command.request_object = batch_approve_publisher_connections_request_object
+          command.response_representation = Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::BatchApprovePublisherConnectionsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Batch rejects multiple publisher connections.
+        # @param [String] parent
+        #   Required. The bidder for whom publisher connections will be rejected. Format: `
+        #   bidders/`bidder`` where ``bidder`` is the account ID of the bidder.
+        # @param [Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsRequest] batch_reject_publisher_connections_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batch_reject_publisher_connections(parent, batch_reject_publisher_connections_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/publisherConnections:batchReject', options)
+          command.request_representation = Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsRequest::Representation
+          command.request_object = batch_reject_publisher_connections_request_object
+          command.response_representation = Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::BatchRejectPublisherConnectionsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a publisher connection.
+        # @param [String] name
+        #   Required. Name of the publisher whose connection information is to be
+        #   retrieved. In the pattern `bidders/`bidder`/publisherConnections/`publisher``
+        #   where ``bidder`` is the account ID of the bidder, and ``publisher`` is the ads.
+        #   txt/app-ads.txt publisher ID. See publisherConnection.name.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::PublisherConnection] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::PublisherConnection]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_bidder_publisher_connection(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::PublisherConnection::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::PublisherConnection
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists publisher connections for a given bidder.
+        # @param [String] parent
+        #   Required. Name of the bidder for which publishers have initiated connections.
+        #   The pattern for this resource is `bidders/`bidder`` where ``bidder``
+        #   represents the account ID of the bidder.
+        # @param [String] filter
+        #   Query string to filter publisher connections. Connections can be filtered by `
+        #   displayName`, `publisherPlatform`, and `biddingState`. If no filter is
+        #   specified, all publisher connections will be returned. Example: 'displayName="
+        #   Great Publisher*" AND publisherPlatform=ADMOB AND biddingState != PENDING' See
+        #   https://google.aip.dev/160 for more information about filtering syntax.
+        # @param [String] order_by
+        #   Order specification by which results should be sorted. If no sort order is
+        #   specified, the results will be returned in alphabetic order based on the
+        #   publisher's publisher code. Results can be sorted by `createTime`. Example: '
+        #   createTime DESC'.
+        # @param [Fixnum] page_size
+        #   Requested page size. The server may return fewer results than requested (due
+        #   to timeout constraint) even if more are available through another call. If
+        #   unspecified, the server will pick an appropriate default. Acceptable values
+        #   are 1 to 5000, inclusive.
+        # @param [String] page_token
+        #   A token identifying a page of results the server should return. Typically,
+        #   this is the value of ListPublisherConnectionsResponse.nextPageToken returned
+        #   from the previous call to the 'ListPublisherConnections' method.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::ListPublisherConnectionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::ListPublisherConnectionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_bidder_publisher_connections(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/publisherConnections', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::ListPublisherConnectionsResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::ListPublisherConnectionsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a buyer account by its name.
         # @param [String] name
-        #   Required. To fetch remarketing tag for an account, name must follow the
-        #   pattern `buyers/`accountId`` where ``accountId`` represents ID of a buyer that
-        #   owns the remarketing tag. For a bidder accessing remarketing tag on behalf of
-        #   a child seat buyer, ``accountId`` should represent the ID of the child seat
-        #   buyer. To fetch remarketing tag for a specific user list, name must follow the
-        #   pattern `buyers/`accountId`/userLists/`userListId``. See UserList.name.
+        #   Required. Name of the buyer to get. Format: `buyers/`buyerId``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::Buyer] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::Buyer]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_buyer(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::Buyer::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::Buyer
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # This has been sunset as of October 2023, and will return an error response if
+        # called. For more information, see the release notes: https://developers.google.
+        # com/authorized-buyers/apis/relnotes#real-time-bidding-api Gets remarketing tag
+        # for a buyer. A remarketing tag is a piece of JavaScript code that can be
+        # placed on a web page. When a user visits a page containing a remarketing tag,
+        # Google adds the user to a user list.
+        # @param [String] name
+        #   Required. To fetch the remarketing tag for an account, the name must follow
+        #   the pattern `buyers/`accountId``, where ``accountId`` represents the ID of the
+        #   buyer that owns the remarketing tag. For a bidder accessing the remarketing
+        #   tag on behalf of a child seat buyer, ``accountId`` should represent the ID of
+        #   the child seat buyer. To fetch the remarketing tag for a specific user list,
+        #   the name must follow the pattern `buyers/`accountId`/userLists/`userListId``.
+        #   See UserList.name.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -641,6 +1017,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists all buyer account information the calling buyer user or service account
+        # is permissioned to manage.
+        # @param [Fixnum] page_size
+        #   The maximum number of buyers to return. If unspecified, at most 100 buyers
+        #   will be returned. The maximum value is 500; values above 500 will be coerced
+        #   to 500.
+        # @param [String] page_token
+        #   A token identifying a page of results the server should return. This value is
+        #   received from a previous `ListBuyers` call in ListBuyersResponse.nextPageToken.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::RealtimebiddingV1::ListBuyersResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RealtimebiddingV1::ListBuyersResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_buyers(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/buyers', options)
+          command.response_representation = Google::Apis::RealtimebiddingV1::ListBuyersResponse::Representation
+          command.response_class = Google::Apis::RealtimebiddingV1::ListBuyersResponse
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a creative.
         # @param [String] parent
         #   Required. The name of the parent buyer that the new creative belongs to that
@@ -714,7 +1127,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists creatives.
+        # Lists creatives as they are at the time of the initial request. This call may
+        # take multiple hours to complete. For large, paginated requests, this method
+        # returns a snapshot of creatives at the time of request for the first page. `
+        # lastStatusUpdate` and `creativeServingDecision` may be outdated for creatives
+        # on sequential pages. We recommend [Google Cloud Pub/Sub](//cloud.google.com/
+        # pubsub/docs/overview) to view the latest status.
         # @param [String] parent
         #   Required. Name of the parent buyer that owns the creatives. The pattern for
         #   this resource is either `buyers/`buyerAccountId`` or `bidders/`bidderAccountId`
@@ -725,8 +1143,8 @@ module Google
         #   123`), you would use the pattern: `buyers/456`. 3. The ID of the bidder itself.
         #   So for listing creatives pertaining to bidder (`123`), you would use `buyers/
         #   123`. If you want to access all creatives pertaining to both the bidder and
-        #   all of its child seat accounts, you would use `bidders/`bidderAccountId``, e.g.
-        #   , for all creatives pertaining to bidder (`123`), use `bidders/123`.
+        #   all of its child seat accounts, you would use `bidders/`bidderAccountId``, for
+        #   example, for all creatives pertaining to bidder (`123`), use `bidders/123`.
         # @param [String] filter
         #   Query string to filter creatives. If no filter is specified, all active
         #   creatives will be returned. Example: 'accountId=12345 AND (dealsStatus:
@@ -734,13 +1152,15 @@ module Google
         #   IS_COOKIE_TARGETED'
         # @param [Fixnum] page_size
         #   Requested page size. The server may return fewer creatives than requested (due
-        #   to timeout constraint) even if more are available via another call. If
+        #   to timeout constraint) even if more are available through another call. If
         #   unspecified, server will pick an appropriate default. Acceptable values are 1
         #   to 1000, inclusive.
         # @param [String] page_token
         #   A token identifying a page of results the server should return. Typically,
         #   this is the value of ListCreativesResponse.nextPageToken returned from the
-        #   previous call to the 'ListCreatives' method.
+        #   previous call to the 'ListCreatives' method. Page tokens for continued pages
+        #   are valid for up to five hours, counting from the call to 'ListCreatives' for
+        #   the first page.
         # @param [String] view
         #   Controls the amount of information included in the response. By default only
         #   creativeServingDecision is included. To retrieve the entire creative resource (
@@ -816,8 +1236,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Change the status of a user list to CLOSED. This prevents new users from being
-        # added to the user list.
+        # Changes the status of a user list to CLOSED. This prevents new users from
+        # being added to the user list.
         # @param [String] name
         #   Required. The name of the user list to close. See UserList.name
         # @param [Google::Apis::RealtimebiddingV1::CloseUserListRequest] close_user_list_request_object
@@ -850,12 +1270,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a new user list.
+        # Creates a new user list.
         # @param [String] parent
-        #   Required. The name of the parent buyer of the user list to be retrieved that
+        #   Required. The name of the parent buyer of the user list to be retrieved, which
         #   must follow the pattern `buyers/`buyerAccountId``, where ``buyerAccountId``
-        #   represents the account ID of the buyer who owns user lists. For a bidder
-        #   accessing user lists on behalf of a child seat buyer , ``buyerAccountId``
+        #   represents the account ID of the buyer who owns the user list. For a bidder
+        #   accessing user lists on behalf of a child seat buyer, ``buyerAccountId``
         #   should represent the account ID of the child seat buyer.
         # @param [Google::Apis::RealtimebiddingV1::UserList] user_list_object
         # @param [String] fields
@@ -917,16 +1337,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets remarketing tag for a buyer. A remarketing tag is a piece of JavaScript
-        # code that can be placed on a web page. When a user visits a page containing a
-        # remarketing tag, Google adds the user to a user list.
+        # This has been sunset as of October 2023, and will return an error response if
+        # called. For more information, see the release notes: https://developers.google.
+        # com/authorized-buyers/apis/relnotes#real-time-bidding-api Gets remarketing tag
+        # for a buyer. A remarketing tag is a piece of JavaScript code that can be
+        # placed on a web page. When a user visits a page containing a remarketing tag,
+        # Google adds the user to a user list.
         # @param [String] name
-        #   Required. To fetch remarketing tag for an account, name must follow the
-        #   pattern `buyers/`accountId`` where ``accountId`` represents ID of a buyer that
-        #   owns the remarketing tag. For a bidder accessing remarketing tag on behalf of
-        #   a child seat buyer, ``accountId`` should represent the ID of the child seat
-        #   buyer. To fetch remarketing tag for a specific user list, name must follow the
-        #   pattern `buyers/`accountId`/userLists/`userListId``. See UserList.name.
+        #   Required. To fetch the remarketing tag for an account, the name must follow
+        #   the pattern `buyers/`accountId``, where ``accountId`` represents the ID of the
+        #   buyer that owns the remarketing tag. For a bidder accessing the remarketing
+        #   tag on behalf of a child seat buyer, ``accountId`` should represent the ID of
+        #   the child seat buyer. To fetch the remarketing tag for a specific user list,
+        #   the name must follow the pattern `buyers/`accountId`/userLists/`userListId``.
+        #   See UserList.name.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -964,7 +1388,7 @@ module Google
         # @param [Fixnum] page_size
         #   The number of results to return per page.
         # @param [String] page_token
-        #   Continuation page token (as received from a previous response).
+        #   Continuation page token as received from a previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -994,8 +1418,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Change the status of a user list to OPEN. This allows new users to be added to
-        # the user list.
+        # Changes the status of a user list to OPEN. This allows new users to be added
+        # to the user list.
         # @param [String] name
         #   Required. The name of the user list to open. See UserList.name
         # @param [Google::Apis::RealtimebiddingV1::OpenUserListRequest] open_user_list_request_object
@@ -1028,7 +1452,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the given user list. Only user lists with URLRestrictions can be
+        # Updates the given user list. Only user lists with URLRestrictions can be
         # updated.
         # @param [String] name
         #   Output only. Name of the user list that must follow the pattern `buyers/`buyer`