Method: sellers.creativeAssets.list

  • This method lists creative assets for a given seller.

  • The request uses a GET method and includes a required parent path parameter for the seller ID.

  • Optional query parameters include pageSize to limit results, pageToken for pagination, and filter to filter by external ID.

  • A successful response returns a list of creative assets and a nextPageToken for subsequent requests.

  • This method requires the https://www.googleapis.com/auth/doubleclickbidmanager OAuth scope for authorization.

Lists creative assets.

  • For example GET /v1/sellers/321/creativeAssets
  • Returns a list of creative assets and a token to retrieve the next page if successful.
  • Returns error code INVALID_ARGUMENT if sellers provide an invalid page size or page token.

HTTP request

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/creativeAssets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The seller, which owns this collection of creative assets. Format: sellers/{seller}

Query parameters

Parameters
pageSize

integer

The maximum number of items to return. The service may return fewer than this value. Max allowed number of creative assets is 1000; values above 1000 will be changed to 1000. If unspecified, at most 1000 creative assets will be returned.

pageToken

string

The nextPageToken value returned from a previous List request, if any.

filter

string

The list filter. Currently supports external ID filtering, with the syntax: "externalId = [EXTERNAL_ID]". The logical operators AND and OR can be used to chain filters.

Request body

The request body must be empty.

Response body

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

JSON representation
{
  "creativeAssets": [
    {
      object (CreativeAsset)
    }
  ],
  "nextPageToken": string
}
Fields
creativeAssets[]

object (CreativeAsset)

The list of creative assets.

nextPageToken

string

A token to retrieve the next page of results. Pass this value in the pageToken field in the subsequent call to creativeAssets.list method to retrieve the next page of results.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/doubleclickbidmanager

For more information, see the OAuth 2.0 Overview.