Home Guides Reference Samples Support Policies Vendors

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 Operation.name can be then be used to poll for status, wait for completion, or cancel the operation.

HTTP request

POST https://fullcirclequery.googleapis.com/v2/queries:execute

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
}
Fields
query

object (Query)

Fully defined query to execute.

spec

object (QueryExecutionSpec)

The query parameter specification used for execution.

timeoutMs

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:

  • https://www.googleapis.com/auth/adsdatahub
  • https://www.googleapis.com/auth/xapi.zoo