Method: customers.analysisQueries.validate

Esegue controlli di convalida statici sulla query di analisi fornita.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
parent

string

Il nome della risorsa principale a cui appartiene la query, ad esempio 'customers/123'.

Corpo della richiesta

Il corpo della richiesta contiene i dati con la seguente struttura:

Rappresentazione JSON 
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Campi
query

object (AnalysisQuery)

La query da convalidare.
adsDataCustomerId
(deprecated)

string (int64 format)

(Facoltativo) ID cliente Ads Data Hub collegato da utilizzare per convalidare l'accesso ai dati pubblicitari e alla tabella temporanea. Il valore predefinito è per tutti i clienti collegati. Deprecato. Utilizza adsDataCustomerId in query_execution_spec.
matchDataCustomerId
(deprecated)

string (int64 format)

(Facoltativo) ID cliente Ads Data Hub specifico da utilizzare per la convalida dei dati delle corrispondenze e dell'accesso alla tabella temporanea. Il valore predefinito è per tutti i clienti collegati. Deprecato. Utilizza il campo match_table_customer_id in query_execution_spec.
spec

object (QueryExecutionSpec)

(Facoltativo) I campi duplicati all'interno di query_execution_spec sostituiranno i campi esterni.
includePerformanceInfo

boolean

(Facoltativo) Se true, chiama BigQuery per eseguire la query in modo da raccogliere alcune informazioni sulle prestazioni. Potrebbe essere necessario più tempo rispetto alla convalida della query. I valori startDate, endDate e parametri all'interno di query_execution_spec devono essere impostati per la prova.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risposta a una richiesta Query.Validate.

Rappresentazione JSON 
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Campi
processedBytes
(deprecated)

string (int64 format)

Ritirato e utilizza invece queryPerformanceInfo. Byte di dati letti da questa query. Consulta https://cloud.google.com/bigquery/pricing#data per i dettagli su come viene calcolato. Restituito se include PerformanceInfo. Arrotondamo i Byte elaborati in MB, quindi li convertiremo in byte. -1 significa che non è stato possibile recuperarlo per questa query.
queryPerformanceInfo

object (QueryPerformanceInfo)

Restituito se include PerformanceInfo.
filteredRowSummary

object (FilteredRowSummary)

Riepilogo delle righe filtrate che verrebbero utilizzate quando la query viene eseguita: le righe che non sono sufficientemente aggregate vengono eliminate dal risultato, mentre il riepilogo delle righe filtrate descrive come riassumere queste righe. Per maggiori dettagli, consulta la pagina https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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