Method: queries.execute

Synchronously executes the query defined in ExecuteQueryRequest. Does not allow for execution of any stored query. The results will be written to the specified destination table. A timeout value is passed in with the execution request. If the timeout passes before the job completes, the 'done' field in the response will be false. The returned can be then be used to poll for status, wait for completion, or cancel the operation.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "query": {
    object (Query)
  "spec": {
    object (QueryExecutionSpec)
  "timeoutMs": string

object (Query)

Fully defined query to execute.


object (QueryExecutionSpec)

The query parameter specification used for execution.


string (int64 format)

Time to wait for the operation to complete. Default value is 10 seconds. If the operation does not complete within this time, a cancel request is sent. An explicit value of 0 is ignored; the default value of 10 seconds is used instead. A negative value results in an invalid argument error.

Response body

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

Authorization Scopes

Requires one of the following OAuth scopes: