GOgoogle
advertisers

GET /v4/advertisers/{advertisersId}/adAssets

Lists ad assets under an advertiser ID. Only supports the retrieval of assets of AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

Request

  • Base URL
    https://displayvideo.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/display-video
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/display-video
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

advertisersIdstring required

Query parameters

filterstring

Optional. Allows filtering of the results by ad asset fields. Supported syntax: * A restriction has the form of {field} {operator} {value}. * All fields must use the EQUALS (=) operator. Supported fields: * youtubeVideoAsset.youtubeVideoId * entityStatus Examples: * All active YouTube video ad assets under an advertiser: entityStatus=ENTITY_STATUS_ACTIVE

orderBystring

Optional. Field by which to sort the list. Acceptable values are: * entityStatus * youtubeVideoAsset.youtubeVideoId * adAssetId (default) The default sorting order is ascending. To specify descending order for a field, a suffix "desc" should be added to the field name. Example: adAssetId desc.

pageSizeinteger

Optional. Requested page size. Must be between 1 and 5000. If unspecified will default to 5000. Returns error code INVALID_ARGUMENT if an invalid value is specified.

pageTokenstring

Optional. A token identifying a page of results the server should return. Typically, this is the value of next_page_token returned from the previous call to ListAdAssets method. If not specified, the first page of results will be returned.

Response

Successful response

nextPageTokenstring

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

Changes

No recorded changes to this operation across all 7 revisions of this API.