Method: customers.adsDataLinks.list

  • Lists existing links between a specified Google Ads customer and other Google advertising entities, like Campaign Manager or Display & Video 360.

  • Retrieves a paginated list of AdsDataLinks, allowing you to specify the page size and use tokens for navigating through results.

  • Supports filtering results based on criteria such as name, platform, status, creation/update time, vendor client ID, and available metrics.

  • Requires authorization with the https://www.googleapis.com/auth/adsdatahub scope for access.

Lists links between the specified customer and other Google advertising entities.

HTTP request

GET https://adsdatahub.googleapis.com/v1/{parent=customers/*}/adsDataLinks

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Parent customer resource name, e.g. 'customers/123'.

Query parameters

Parameters
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.
filter

string

Filters your response. Works using the following fields / formatting: name="customers/1/adsDataLinks/CNC0w8IFEAEYAQ" platform="GOOGLE_ADS" status="PENDING" create_time.seconds>unix_seconds update_time.seconds>unix_seconds vendorClientId="vendor_customer" metrics="VIEWABILITY"

Request body

The request body must be empty.

Response body

Response to a adsDataLinks.list request.

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

JSON representation 
{
  "links": [
    {
      object (AdsDataLink)
    }
  ],
  "nextPageToken": string
}
Fields
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