REST Resource: buyers.auctionPackages

Resource: AuctionPackage

Defines a segment of inventory that buyer wants to buy. It's created by buyer and could be shared with multiple buyers.

JSON representation
{
  "name": string,
  "creator": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "subscribedClients": [
    string
  ]
}
Fields
name

string

Immutable. 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.

creator

string

Output only. The buyer that created this auction package. Format: buyers/{buyerAccountId}

displayName

string

The displayName assigned to the auction package.

description

string

Output only. A description of the auction package.

createTime

string (Timestamp format)

Output only. Time the auction package was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output 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.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

subscribedClients[]

string

Output only. The list of clients of the current buyer that are subscribed to the AuctionPackage. Format: buyers/{buyerAccountId}/clients/{clientAccountId}

Methods

get

Gets an auction package given its name.

list

List the auction packages subscribed by a buyer and its clients.

subscribe

Subscribe to the auction package for the specified buyer.

subscribeClients

Subscribe the specified clients of the buyer to the auction package.

unsubscribe

Unsubscribe from the auction package for the specified buyer.

unsubscribeClients

Unsubscribe from the auction package for the specified clients of the buyer.