Ads Data Hub API

API for executing Ads Data Hub queries.

Service: adsdatahub.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://adsdatahub.googleapis.com

REST Resource: v1.customers

Methods
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Lists valid event matchers along with their metadata for frequency capping audience lists.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Exports job history of a customer account to customer-selected BigQuery dataset.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Starts the execution of a query to retrieve invalid traffic viewability metrics for the DV360 platform.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Starts the execution of a query to retrieve a day-by-day summary of invalid traffic counts for a specific platform.
get GET /v1/{name=customers/*}
Retrieves the requested Ads Data Hub customer.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Returns the percentage of Google data across all customers that has successfully been ingested into ADH on the given date.
list GET /v1/customers
Lists Ads Data Hub customers to which the current user has access.

REST Resource: v1.customers.analysisQueries

Methods
create POST /v1/{parent=customers/*}/analysisQueries
Creates an analysis query for later execution.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Deletes an analysis query.
get GET /v1/{name=customers/*/analysisQueries/*}
Retrieves the requested analysis query.
list GET /v1/{parent=customers/*}/analysisQueries
Lists the analysis queries owned by the specified customer.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Updates an existing analysis query.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Starts execution on a stored analysis query.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Starts execution on a transient analysis query.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Performs static validation checks on the provided analysis query.

REST Resource: v1.customers.tables

Methods
get GET /v1/{name=customers/*/tables/*}
Retrieves the requested Ads Data Hub table.
list GET /v1/{parent=customers/*}/tables
Lists the Ads Data Hub tables to which the specified customer has access.

REST Resource: v1.customers.tempTables

Methods
get GET /v1/{name=customers/*/tempTables/*}
Retrieves the requested Ads Data Hub temp table.
list GET /v1/{parent=customers/*}/tempTables
Lists the Ads Data Hub temp tables that the customer has created.

REST Resource: v1.customers.userListQueries

Methods
create POST /v1/{parent=customers/*}/userListQueries
Creates a user list query for later execution.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Deletes a user list query.
get GET /v1/{name=customers/*/userListQueries/*}
Retrieves the requested user list query.
list GET /v1/{parent=customers/*}/userListQueries
Lists the user list queries owned by the specified customer.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Updates an existing user list query.
start POST /v1/{name=customers/*/userListQueries/*}:start
Starts execution on a stored user list query.
startTransient POST /v1/{parent=customers/*}/userListQueries:startTransient
Starts execution on a transient user list query.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Performs static validation checks on the provided user list query.

REST Resource: v1.customers.userLists

Methods
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Adds event matchers to a frequency-based user list.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Add entities to an Ads Data Hub-managed user list’s recipients.
create POST /v1/{parent=customers/*}/userLists
Creates an Ads Data Hub-managed user list.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Generate memberships for the UserList.
get GET /v1/{name=customers/*/userLists/*}
Retrieves the requested Ads Data Hub-managed user list.
list GET /v1/{parent=customers/*}/userLists
Lists the user lists managed by the specified Ads Data Hub customer.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Updates the requested Ads Data Hub-managed user list.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Removes entities from an Ads Data Hub-managed user list’s recipients.

REST Resource: v1.operations

Methods
cancel POST /v1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=operations/**}
Deletes a long-running operation.
get GET /v1/{name=operations/**}
Gets the latest state of a long-running operation.
list GET /v1/{name}
Lists operations that match the specified filter in the request.
wait POST /v1/{name=operations/**}:wait
Waits for the specified long-running operation until it is done or reaches at most a specified timeout, returning the latest state.

REST Resource: v1.outages

Methods
list GET /v1/outages
Lists the outages in descending order of outage start timestamp, and the look back window is 130 days.