Method: customers.analysisQueries.validate

Führt statische Validierungsprüfungen für die bereitgestellte Analyseabfrage durch.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Der Name der übergeordneten Ressource, zu der die Abfrage gehört, z.B. 'customers/123'.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "query": {
    object (AnalysisQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
Felder
query

object (AnalysisQuery)

Die zu validierende Abfrage.

adsDataCustomerId
(deprecated)

string (int64 format)

Optional. Eine bestimmte verknüpfte Ads Data Hub-Kundennummer, die zum Validieren der Anzeigendaten und des temporären Tabellenzugriffs verwendet wird. Die Standardeinstellung ist alle verknüpften Kunden. Veraltet. Verwenden Sie „adsDataCustomerId“ in „query_execution_spec“.

matchDataCustomerId
(deprecated)

string (int64 format)

Optional. Eine bestimmte verknüpfte Ads Data Hub-Kundennummer, die zum Validieren der Zuordnungsdaten und des temporären Tabellenzugriffs verwendet wird. Die Standardeinstellung ist alle verknüpften Kunden. Veraltet. Verwenden Sie „match_table_customer_id“ in „query_ execution_spec“.

spec

object (QueryExecutionSpec)

Optional. Die duplizierten Felder in „query_execution_spec“ überschreiben die Felder außerhalb.

includePerformanceInfo

boolean

Optional. Rufen Sie BigQuery auf, um die Abfrage im Probelauf auszuführen, um einige Leistungsinformationen zu erfassen. Der Wert kann länger dauern als die Validierung der Abfrage. Für das Probelauf müssen startDate, endDate und die Parameter in der Abfrageabfrageausführung festgelegt werden.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort auf eine Anfrage von analyticsQuery.valid.

JSON-Darstellung
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  },
  "filteredRowSummary": {
    object (FilteredRowSummary)
  }
}
Felder
processedBytes
(deprecated)

string (int64 format)

Eingestellt. Verwenden Sie stattdessen queryPerformanceInfo. Bytes der Daten, die diese Abfrage liest. Weitere Informationen zur Berechnung finden Sie unter https://cloud.google.com/bigquery/pricing#data. Wird zurückgegeben, wenn includeLeistungInfo wahr ist. Wir verarbeiten die verarbeiteten Byte in MB und konvertieren sie dann in Byte. -1 bedeutet, dass sie für diese Abfrage nicht abgerufen werden konnte.

queryPerformanceInfo

object (QueryPerformanceInfo)

Wird zurückgegeben, wenn includeLeistungInfo wahr ist.

filteredRowSummary

object (FilteredRowSummary)

Gefilterte Zeilenzusammenfassung, die verwendet wird, wenn die Abfrage ausgeführt wird: Die Zeilen, die nicht ausreichend aggregiert sind, werden aus dem Ergebnis entfernt. Die gefilterte Zeilenzusammenfassung beschreibt, wie diese Zeilen zusammengefasst werden. Weitere Informationen finden Sie unter https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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