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:
|
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.