1. class
  2. Google
  3. \
  4. Service
  5. \
  6. RealTimeBidding
  7. \
  8. Resource
  9. \
  10. BiddersCreatives

BiddersCreatives

class BiddersCreatives extends Resource (View source)

The "creatives" collection of methods.

Typical usage is:

 $realtimebiddingService = new Google\Service\RealTimeBidding(...);
 $creatives = $realtimebiddingService->bidders_creatives;

Methods

ListCreativesResponse
listBiddersCreatives(string $parent, array $optParams = [])

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.

WatchCreativesResponse
watch(string $parent, WatchCreativesRequest $postBody, array $optParams = [])

Watches all creatives pertaining to a bidder. It is sufficient to invoke this endpoint once per bidder. A Pub/Sub topic will be created and notifications will be pushed to the topic when any of the bidder's creatives change status.

Details

at line 77
ListCreativesResponse listBiddersCreatives(string $parent, array $optParams = [])

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 to view the latest status. (creatives.listBiddersCreatives)

Parameters

string $parent

Required. Name of the parent buyer that owns the creatives. The pattern for this resource is either buyers/{buyerAccountId} or bidders/{bidderAccountId}. For buyers/{buyerAccountId}, the buyerAccountId can be one of the following: 1. The ID of the buyer that is accessing their own creatives. 2. The ID of the child seat buyer under a bidder account. So for listing creatives pertaining to the child seat buyer (456) under bidder account (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}, for example, for all creatives pertaining to bidder (123), use bidders/123.
array $optParams

Optional parameters.

Return Value

ListCreativesResponse

Exceptions

Exception

at line 99
WatchCreativesResponse watch(string $parent, WatchCreativesRequest $postBody, array $optParams = [])

Watches all creatives pertaining to a bidder. It is sufficient to invoke this endpoint once per bidder. A Pub/Sub topic will be created and notifications will be pushed to the topic when any of the bidder's creatives change status.

All of the bidder's service accounts will have access to read from the topic. Subsequent invocations of this method will return the existing Pub/Sub configuration. (creatives.watch)

Parameters

string $parent

Required. To watch all creatives pertaining to the bidder and all its child seat accounts, the bidder must follow the pattern bidders/{bidderAccountId}.
WatchCreativesRequest $postBody
array $optParams

Optional parameters.

Return Value

WatchCreativesResponse

Exceptions

Exception