Method: customers.analysisQueries.validate

Realiza verificações de validação estáticas na consulta de análise fornecida.

Solicitação HTTP

POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/analysisQueries:validate

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

Parâmetros de caminho

Parâmetros
parent

string

O nome do recurso pai que tem a consulta, por exemplo, 'customers/123'.

Corpo da solicitação

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

Representação JSON
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Campos
query

object (AnalysisQuery)

A consulta a ser validada.

adsDataCustomerId
(deprecated)

string (int64 format)

Opcional. ID do cliente específico do Ads Data Hub a ser usado para validar os dados dos anúncios e o acesso à tabela temporária. O padrão é todos os clientes vinculados. Obsoleto. Use o adsDataCustomerId em query_execution_spec.

matchDataCustomerId
(deprecated)

string (int64 format)

Opcional. ID de cliente específico do Ads Data Hub a ser usado para validar os dados de correspondência e o acesso à tabela temporária. O padrão é todos os clientes vinculados. Obsoleto. Use o match_table_customer_id em query_execution_spec.

spec

object (QueryExecutionSpec)

Opcional. Os campos duplicados dentro de query_execution_spec substituem os campos externos.

includePerformanceInfo

boolean

Opcional. Se for verdadeiro, chame o BigQuery para secar a consulta e coletar informações de desempenho. Isso pode levar mais tempo do que validar apenas a consulta. O startDate, endDate e os parâmetros em query_execution_spec precisam ser definidos para a simulação.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Resposta a uma solicitação analyticsQuery.validate.

Representação JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Campos
processedBytes
(deprecated)

string (int64 format)

O uso foi suspenso. Em vez disso, use queryPerformanceInfo. Bytes de dados que esta consulta lê. Consulte https://cloud.google.com/bigquery/pricing#data para ver detalhes sobre como isso é calculado. Retornado se includePerformanceInfo for verdadeiro. Arredondamos os bytes processados para MB e os convertemos em bytes. -1 significa que não foi possível buscar essa consulta.

queryPerformanceInfo

object (QueryPerformanceInfo)

Retornado se includePerformanceInfo for verdadeiro.

filteredRowSummary

object (FilteredRowSummary)

O resumo de linhas filtradas é usado quando a consulta é executada: as linhas que não são agregadas o suficiente são descartadas do resultado. O resumo de linhas filtradas descreve como resumir essas linhas. Para mais detalhes, consulte https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Escopos de autorização

Requer o seguinte escopo OAuth:

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