Method: customers.analysisQueries.start

Inicia a execução em uma consulta de análise armazenada. Os resultados serão gravados na tabela de destino especificada do BigQuery. O nome da operação retornada pode ser usado para pesquisar o status de conclusão da consulta.

Solicitação HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*/analysisQueries/*}:start

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Nome completo do recurso, por exemplo, 'customers/123/analysisQuery/abcd1234'.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "destTable": string,
  "customerId": string
}
Campos
spec

object (QueryExecutionSpec)

Define os parâmetros de execução da consulta.

destTable

string

Tabela de destino do BigQuery para resultados da consulta com o formato 'project.dataset.table_name'. Se especificado, o projeto precisa estar explicitamente na lista de permissões da conta do ADH do cliente. Se o projeto não for especificado, o projeto padrão será usado para o cliente informado. Se nem o projeto nem o conjunto de dados forem especificados, usará o projeto e o conjunto de dados padrão.

customerId

string (int64 format)

Opcional. Cliente do Ads Data Hub que executa a consulta. Caso o valor não seja especificado, o padrão será o cliente proprietário da consulta.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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