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

BuyersCreatives

class BuyersCreatives extends Resource (View source)

The "creatives" collection of methods.

Typical usage is:

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

Methods

Creative
create(string $parent, Creative $postBody, array $optParams = [])

Creates a creative. (creatives.create)

Creative
get(string $name, array $optParams = [])

Gets a creative. (creatives.get)

ListCreativesResponse
listBuyersCreatives(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.

Creative
patch(string $name, Creative $postBody, array $optParams = [])

Updates a creative. (creatives.patch)

Details

at line 46
Creative create(string $parent, Creative $postBody, array $optParams = [])

Creates a creative. (creatives.create)

Parameters

string $parent

Required. The name of the parent buyer that the new creative belongs to that must follow the pattern buyers/{buyerAccountId}, where {buyerAccountId} represents the account ID of the buyer who owns a creative. For a bidder accessing creatives on behalf of a child seat buyer, {buyerAccountId} should represent the account ID of the child seat buyer.
Creative $postBody
array $optParams

Optional parameters.

Return Value

Creative

Exceptions

Exception

at line 66
Creative get(string $name, array $optParams = [])

Gets a creative. (creatives.get)

Parameters

string $name

Required. Name of the creative to retrieve. See creative.name.
array $optParams

Optional parameters.

Return Value

Creative

Exceptions

Exception

at line 115
ListCreativesResponse listBuyersCreatives(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.listBuyersCreatives)

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 135
Creative patch(string $name, Creative $postBody, array $optParams = [])

Updates a creative. (creatives.patch)

Parameters

string $name

Output only. Name of the creative. Follows the pattern buyers/{buyer}/creatives/{creative}, where {buyer} represents the account ID of the buyer who owns the creative, and {creative} is the buyer-specific creative ID that references this creative in the bid response.
Creative $postBody
array $optParams

Optional parameters.

Return Value

Creative

Exceptions

Exception