Method: customers.userListQueries.startTransient

  • The StartTransientUserListQuery method is deprecated and users should use StartUserListQuery instead.

  • This method starts the execution of a temporary user list query, uploading the results to a specified Google Ads user list.

  • The HTTP request method is POST and the URL uses gRPC Transcoding syntax with a required parent path parameter representing the customer.

  • The request body requires a query, query execution specifications, and a Google Ads user list ID.

  • A successful response returns an Operation object, and the method requires the https://www.googleapis.com/auth/adsdatahub OAuth scope for authorization.

Starts execution on a transient 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/{parent=customers/*}/userListQueries:startTransient

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Full resource name of the customer executing the query, e.g. 'customers/123'.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "query": {
    object (UserListQuery)
  },
  "spec": {
    object (QueryExecutionSpec)
  },
  "userListId": string
}
Fields
query

object (UserListQuery)

The query to execute.
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.

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