We've updated our documentation with the latest features and updates introduced by Ads Data Hub's
two new experiences.
Advertisers, agencies, and publishers, refer to the
Marketers site.
Vendors and partners, refer to the
Measurement Partners site.
Method: customers.userListQueries.start
Starts execution on a stored user list query. The results uploaded to the specified Google Ads user list. The returned operation name can be used to poll for query completion status.
HTTP request
POST https://adsdatahub.googleapis.com/v1/{name=customers/*/userListQueries/*}:start
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
name |
string
Full resource name, e.g. 'customers/123/userListQueries/abcd1234'.
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"spec": {
object (QueryExecutionSpec )
},
"userListId": string,
"customerId": string
} |
Fields |
spec |
object (QueryExecutionSpec )
Defines the query execution parameters.
|
userListId |
string (int64 format)
Google Ads user list ID. Note that the user list must be managed by the Ads Data Hub customer executing the query.
|
customerId |
string (int64 format)
Optional. Ads Data Hub customer executing the query. If not specified, defaults to the customer that owns the query.
|
Response body
If successful, the response body contains an instance of Operation
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/adsdatahub
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["Starts execution of a stored user list query and uploads the results to a specified Google Ads user list."],["Users can track query completion status via the returned operation name."],["The request requires specifying the query execution parameters, Google Ads user list ID, and optionally, the Ads Data Hub customer ID."],["Successful execution returns an Operation object detailing the status and outcome."],["Authorization requires the `https://www.googleapis.com/auth/adsdatahub` scope."]]],["This document details the process of initiating a user list query in Google Ads Data Hub. A POST request is sent to a specific URL containing the user list query's name. The request body includes query execution parameters (`spec`), a Google Ads user list ID (`userListId`), and an optional customer ID (`customerId`). The query results are uploaded to the specified Google Ads user list. Upon success, an Operation object is returned, indicating the query's status. It also requires OAuth authorization with the `https://www.googleapis.com/auth/adsdatahub` scope.\n"]]