Creatives: list

Requires authorization

Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission. Try it now.

Request

HTTP request

GET https://www.googleapis.com/adexchangebuyer/v1.4/creatives

Parameters

Parameter name Value Description
Optional query parameters
accountId integer When specified, only creatives for the given account ids are returned.
buyerCreativeId string When specified, only creatives for the given buyer creative ids are returned.
dealsStatusFilter string When specified, only creatives having the given deals status are returned.

Acceptable values are:
  • "approved": Creatives which have been approved for serving on deals.
  • "conditionally_approved": Creatives which have been conditionally approved for serving on deals.
  • "disapproved": Creatives which have been disapproved for serving on deals.
  • "not_checked": Creatives whose deals status is not yet checked.
maxResults unsigned integer Maximum number of entries returned on one result page. If not set, the default is 100. Optional. Acceptable values are 1 to 1000, inclusive.
openAuctionStatusFilter string When specified, only creatives having the given open auction status are returned.

Acceptable values are:
  • "approved": Creatives which have been approved for serving on the open auction.
  • "conditionally_approved": Creatives which have been conditionally approved for serving on the open auction.
  • "disapproved": Creatives which have been disapproved for serving on the open auction.
  • "not_checked": Creatives whose open auction status is not yet checked.
pageToken string A continuation token, used to page through the returned list of creatives. To retrieve the next page of results, set this parameter to the value of "nextPageToken" from the previous response. Optional.

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/adexchange.buyer

Request body

Do not supply a request body with this method.

Response

The list of creatives returned by this method include only the kind, accountId, and buyerCreativeId for each active creative. You can call the get method for each item in the list, passing the AccountId and buyerCreativeId values, to get full information about each of your active creatives.

{
  "kind": "adexchangebuyer#creativesList",
  "nextPageToken": string,
  "items": [
    creatives Resource
  ]
}
Property name Value Description Notes
kind string Resource type.
items[] list A list of creatives.
nextPageToken string Continuation token used to page through creatives Store this value in the next request's "pageToken" parameter to retrieve the next set of results.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Send feedback about...

Buyer REST API
Buyer REST API