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.3/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.
`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
`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.