This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
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
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eStarts the execution of a transient analysis query and writes the results to a specified BigQuery destination table.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to the specified endpoint with necessary path parameters and request body data.\u003c/p\u003e\n"],["\u003cp\u003eRequires an authorization scope of \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns an Operation object upon successful execution, allowing for the monitoring of query completion.\u003c/p\u003e\n"],["\u003cp\u003eProvides flexibility in specifying the destination BigQuery table, utilizing defaults if project or dataset are omitted.\u003c/p\u003e\n"]]],["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"],null,["# Method: customers.analysisQueries.startTransient\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nStarts 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.\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries:startTransient`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------|\n| `parent` | `string` Full resource name of the customer executing the query, e.g. 'customers/123'. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"query\": { object (/ads-data-hub/reference/rest/v1/customers.analysisQueries#AnalysisQuery) }, \"spec\": { object (/ads-data-hub/reference/rest/v1/QueryExecutionSpec) }, \"destTable\": string } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `object (`[AnalysisQuery](/ads-data-hub/reference/rest/v1/customers.analysisQueries#AnalysisQuery)`)` The query to execute. |\n| `spec` | `object (`[QueryExecutionSpec](/ads-data-hub/reference/rest/v1/QueryExecutionSpec)`)` Defines the query execution parameters. |\n| `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. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/ads-data-hub/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]
