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.2/creatives

Parameters

Parameter name Value Description
Optional query parameters
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.
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.
statusFilter string When specified, only creatives having the given status are returned.

Acceptable values are:
  • "approved": Creatives which have been approved.
  • "disapproved": Creatives which have been disapproved.
  • "not_checked": Creatives whose status is not yet checked.

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