Skip to main content

auction_packages

Overview

Nameauction_packages
TypeResource
Idgoogledevelopers.authorizedbuyersmarketplace.auction_packages

Fields

NameDatatypeDescription
namestringImmutable. The unique identifier for the auction package. Format: buyers/{accountId}/auctionPackages/{auctionPackageId} The auction_package_id part of name is sent in the BidRequest to all RTB bidders and is returned as deal_id by the bidder in the BidResponse.
descriptionstringOutput only. A description of the auction package.
createTimestringOutput only. Time the auction package was created.
creatorstringOutput only. The buyer that created this auction package. Format: buyers/{buyerAccountId}
displayNamestringThe display_name assigned to the auction package.
subscribedClientsarrayOutput only. The list of clients of the current buyer that are subscribed to the AuctionPackage. Format: buyers/{buyerAccountId}/clients/{clientAccountId}
updateTimestringOutput only. Time the auction package was last updated. This value is only increased when this auction package is updated but never when a buyer subscribed.

Methods

NameAccessible byRequired ParamsDescription
buyers_auctionPackages_getSELECTauctionPackagesId, buyersIdGets an auction package given its name.
buyers_auctionPackages_listSELECTbuyersIdList the auction packages subscribed by a buyer and its clients.
buyers_auctionPackages_subscribeEXECauctionPackagesId, buyersIdSubscribe to the auction package for the specified buyer. Once subscribed, the bidder will receive a call out for inventory matching the auction package targeting criteria with the auction package deal ID and the specified buyer.
buyers_auctionPackages_subscribeClientsEXECauctionPackagesId, buyersIdSubscribe the specified clients of the buyer to the auction package. If a client in the list does not belong to the buyer, an error response will be returned, and all of the following clients in the list will not be subscribed. Subscribing an already subscribed client will have no effect.
buyers_auctionPackages_unsubscribeEXECauctionPackagesId, buyersIdUnsubscribe from the auction package for the specified buyer. Once unsubscribed, the bidder will no longer receive a call out for the auction package deal ID and the specified buyer.
buyers_auctionPackages_unsubscribeClientsEXECauctionPackagesId, buyersIdUnsubscribe from the auction package for the specified clients of the buyer. Unsubscribing a client that is not subscribed will have no effect.