Starts execution on a stored 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/{name=customers/*/analysisQueries/*}:start
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.
[[["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 execution on a stored analysis query and writes results to a specified BigQuery destination table.\u003c/p\u003e\n"],["\u003cp\u003eRequest body includes query execution parameters, destination table, and optional customer ID.\u003c/p\u003e\n"],["\u003cp\u003eResponse returns an operation name for tracking query completion status.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eUses the \u003ccode\u003ePOST\u003c/code\u003e method and gRPC Transcoding syntax for the HTTP request.\u003c/p\u003e\n"]]],["This document details how to initiate a stored analysis query execution in Ads Data Hub. A `POST` request is made to a specific URL, defined by the `name` path parameter (e.g., `customers/*/analysisQueries/*`). The request body, in JSON format, must include `spec` (query execution parameters), `destTable` (BigQuery destination), and optionally `customerId`. Successful requests return an `Operation` instance, and authorization requires the `adsdatahub` OAuth scope. The results will be written into the specified table.\n"],null,["# Method: customers.analysisQueries.start\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 stored 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/{name=customers/*/analysisQueries/*}:start`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------|\n| `name` | `string` Full resource name, e.g. 'customers/123/analysisQueries/abcd1234'. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"spec\": { object (/ads-data-hub/marketers/reference/rest/v1/QueryExecutionSpec) }, \"destTable\": string, \"customerId\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `spec` | `object (`[QueryExecutionSpec](/ads-data-hub/marketers/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| `customerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Optional. Ads Data Hub customer executing the query. If not specified, defaults to the customer that owns the query. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/ads-data-hub/marketers/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]