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.analysisQueries.startTransient
Starts execution on a transient analysis query. The results will be written to the specified BigQuery destination table. The returned operation name can be used to poll for query completion status.
HTTP request
POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries: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:
| Fields |
query |
object (AnalysisQuery)
The query to execute.
|
spec |
object (QueryExecutionSpec)
Defines the query execution parameters.
|
destTable |
string
Destination BigQuery table for query results with the format 'project.dataset.table_name'. If specified, the project must be explicitly whitelisted for the customer's ADH account. If project is not specified, uses default project for the provided customer. If neither project nor dataset is specified, uses the default project and dataset.
|
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 the execution of a transient analysis query and writes the results to a specified BigQuery destination table."],["Uses an HTTP POST request to the specified endpoint with necessary path parameters and request body data."],["Requires an authorization scope of `https://www.googleapis.com/auth/adsdatahub` for access."],["Returns an Operation object upon successful execution, allowing for the monitoring of query completion."],["Provides flexibility in specifying the destination BigQuery table, utilizing defaults if project or dataset are omitted."]]],["This describes initiating a transient analysis query via a POST request to `https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries:startTransient`. The request includes the customer's resource name, query details, execution parameters, and the destination BigQuery table for results. The `query` and `spec` objects define the analysis, while `destTable` specifies the result's location. Successful requests return an Operation instance, and the action requires `https://www.googleapis.com/auth/adsdatahub` authorization scope.\n"]]
