Method: accounts.creatives.list

Lists creatives.

HTTP request

GET https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/creatives

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
accountId

string

The account to list the creatives from. Specify "-" to list all creatives the current user has access to.

Query parameters

Parameters
pageSize

integer

Requested page size. The server may return fewer creatives than requested (due to timeout constraint) even if more are available through another call. If unspecified, server will pick an appropriate default. Acceptable values are 1 to 1000, inclusive.

pageToken

string

A token identifying a page of results the server should return. Typically, this is the value of ListCreativesResponse.next_page_token returned from the previous call to 'creatives.list' method.

query

string

An optional query string to filter creatives. If no filter is specified, all active creatives will be returned.

Supported queries are:

  • accountId=account_id_string
  • creativeId=creative_id_string
  • dealsStatus: {approved, conditionally_approved, disapproved, not_checked}
  • openAuctionStatus: {approved, conditionally_approved, disapproved, not_checked}
  • attribute: {a numeric attribute from the list of attributes}
  • disapprovalReason: {a reason from DisapprovalReason}
Example: 'accountId=12345 AND (dealsStatus:disapproved AND disapprovalReason:unacceptable_content) OR attribute:47'

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

A response for listing creatives.

JSON representation
{
  "creatives": [
    {
      object (Creative)
    }
  ],
  "nextPageToken": string
}
Fields
creatives[]

object (Creative)

The list of creatives.

nextPageToken

string

A token to retrieve the next page of results. Pass this value in the ListCreativesRequest.page_token field in the subsequent call to creatives.list method to retrieve the next page of results.

Authorization Scopes

Requires the following OAuth scope:

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