Method: customers.describeValidDv360AdvertiserIds

  • This document describes how to use the describeValidDv360AdvertiserIds method to get a list of valid DV360 Advertiser IDs.

  • The method uses an HTTP POST request to a specific URL with a path parameter for the customer resource name.

  • The request body requires the Ads Data Owning customer's ID and the DV360 Partner ID, with optional parameters for page size and page token.

  • The response body contains a list of entities, each describing a DV360 Advertiser, and a next page token if more results are available.

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

Describes the valid DV360 AdvertiserIds

HTTP request

POST https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidDv360AdvertiserIds

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customer

string

Required. Customer resource name, e.g. 'customers/123'.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "adsDataCustomerId": string,
  "dv360PartnerId": string,
  "pageSize": integer,
  "pageToken": string
}
Fields
adsDataCustomerId

string (int64 format)

Required. Ads Data Owning customer's ID, e.g. 456.
dv360PartnerId

string (int64 format)

Required. DV360 Partner ID whose Advertiser Ids are requested e.g. 1234 Note that this partner must be linked to the ADH customer speciified by adsDataCustomerId
pageSize

integer

Maximum number of items to return. If 0, the server will determine the number of linked customers to return.
pageToken

string

Page token, returned by a previous call, used to request the next page of results, if any.

Response body

Response to DescribeValidDV360AdvertiserIdsRequest

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

JSON representation 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "nextPageToken": string
}
Fields
entities[]

object (Entity)

List of entities, each describing a DV360 Advertiser
nextPageToken

string

A token that can be used to request the next results page. This field is empty if there are no additional results.

Authorization scopes

Requires the following OAuth scope:

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