Method: customers.analysisQueries.validate

Melakukan pemeriksaan validasi statis pada kueri analisis yang diberikan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Nama resource induk yang memiliki kueri, mis. 'pelanggan/123'.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (AnalysisQuery)

Kueri untuk divalidasi.

adsDataCustomerId
(deprecated)

string (int64 format)

Opsional. ID pelanggan Ads Data Hub spesifik yang digunakan untuk memvalidasi data iklan dan akses tabel sementara. Setelan default-nya adalah semua pelanggan tertaut. Tidak digunakan lagi. Gunakan adsDataCustomerId di dalam query_Execution_spec.

matchDataCustomerId
(deprecated)

string (int64 format)

Opsional. ID pelanggan Ads Data Hub spesifik yang digunakan untuk memvalidasi data pencocokan dan akses tabel sementara. Setelan default-nya adalah semua pelanggan tertaut. Tidak digunakan lagi. Gunakan match_table_customer_id di dalam query_Execution_spec.

spec

object (QueryExecutionSpec)

Opsional. Kolom duplikat di dalam query_Execution_spec akan menggantikan kolom di luar.

includePerformanceInfo

boolean

Opsional. Jika true (benar), panggil BigQuery untuk menjalankan kueri guna mengumpulkan beberapa info performa. Mungkin perlu waktu lebih lama untuk memvalidasi kueri. startDate, endDate, dan parameter di dalam query_Execution_spec perlu ditetapkan untuk dry run.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons terhadap permintaan analyticsQuery.validate.

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

string (int64 format)

Tidak digunakan lagi, dan sebagai gantinya gunakan queryPerformanceInfo. Byte data yang dibaca kueri ini. Lihat https://cloud.google.com/bigquery/pricing#data untuk mengetahui detail tentang cara perhitungannya. Ditampilkan jika includePerformanceInfo benar. Kita membulatkan processingBytes menjadi MB, lalu mengubahnya menjadi byte. -1 berarti kami tidak dapat mengambilnya untuk kueri ini.

queryPerformanceInfo

object (QueryPerformanceInfo)

Ditampilkan jika includePerformanceInfo benar.

filteredRowSummary

object (FilteredRowSummary)

Ringkasan baris yang difilter yang akan digunakan saat kueri dijalankan: baris yang tidak digabungkan secara memadai akan dihapus dari hasil, ringkasan baris yang difilter menjelaskan cara meringkas baris ini. Untuk mengetahui detailnya, lihat https://developers.google.com/ads-data-hub/guides/filtered-row-summary.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

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