Method: queries.start

Executes a query asynchronously and writes the results to the specified destination table in your BigQuery shared dataset. The returned operation id ( can be used to poll for status or wait for completion. When the query completes, Operation.result is populated wtih a QueryResponse message (the same one that queries.execute would return).

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "spec": {
    object (QuerySpec)
  "destTable": string,
  "jobId": string

object (QuerySpec)

The query to execute.



Destination table for query results. Format: "project:dataset.table_name". Your Ads Data Hub service account must have edit permissions for the dataset. If "project:dataset" is not specified, it defaults to your Ads Data Hub shared dataset.



A job id that you supply. You can use this id to refererence your job at operations/jobId. If you omit this field, an id is generated by the server. If you have an existing job with this id, the result is an error.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes: