Validator Kueri Google Ads

Validator Kueri Google Ads adalah alat interaktif yang dirancang untuk membantu developer membuat dan memverifikasi kueri Bahasa Kueri Google Ads (GAQL) sebelum mengintegrasikannya ke dalam aplikasi. Alat ini memungkinkan Anda memasukkan string kueri GAQL dan menerima masukan langsung tentang validitasnya, sehingga membantu mendeteksi error sintaksis, ketidaksesuaian kolom, dan masalah lainnya di awal proses pengembangan.

Manfaat

  • Pencegahan error: Mendeteksi kueri yang tidak valid sejak awal, sebelum diintegrasikan ke dalam aplikasi, sehingga mengurangi error runtime dan kegagalan panggilan API.
  • Pengembangan yang lebih cepat: Memungkinkan pengujian dan proses debug pernyataan GAQL yang cepat tanpa overhead siklus permintaan dan respons API penuh.
  • Memahami batasan GAQL: Membantu developer mempelajari aturan kompleks tentang kolom mana yang kompatibel dan bagaimana resource saling terkait.
  • Men-debug kueri: Memberikan pesan error tertentu saat kueri tidak valid, sering kali lebih mendetail daripada error API umum, dan terkadang menyarankan alternatif yang valid.
  • Efisiensi resource: Menghindari panggilan API yang tidak perlu dengan kueri yang pasti akan gagal.

Cara kerjanya

Query Validator mengurai kueri GAQL Anda berdasarkan skema Google Ads API dan aturan yang ditentukan dalam Bahasa Kueri Google Ads. Alat ini menggunakan metadata, yang sebagian besar dapat diakses dari GoogleAdsFieldService, untuk melakukan pemeriksaan, termasuk:

  1. Sintaksis dan struktur: Memastikan kueri mengikuti tata bahasa GAQL yang benar, termasuk penggunaan dan urutan klausa yang tepat seperti SELECT, FROM, WHERE, ORDER BY, LIMIT, dan PARAMETERS.
  2. Validitas kolom: Memeriksa apakah semua kolom yang ditentukan (resource, segmen, metrik) ada dan dieja dengan benar.
  3. Kompatibilitas resource: Memverifikasi bahwa kolom yang dipilih dalam klausa SELECT kompatibel dengan resource utama yang ditentukan dalam klausa FROM.
  4. Kompatibilitas segmen dan metrik: Memastikan bahwa segmen dan metrik yang digunakan bersama dalam kueri yang sama kompatibel satu sama lain dan dengan resource dalam klausa FROM.
  5. Persyaratan klausa: Memvalidasi aturan seperti persyaratan untuk kolom yang digunakan dalam klausa ORDER BY dan kolom tertentu yang digunakan dalam klausa WHERE (seperti segmen) agar juga ada dalam klausa SELECT.
  6. Penggunaan operator: Memeriksa penggunaan operator yang benar dalam kondisi klausa WHERE.

Jika kueri valid, alat akan mengonfirmasinya. Jika ditemukan masalah, alat ini akan memberikan pesan error yang dirancang untuk membantu mengidentifikasi masalah, terkadang menawarkan saran perbaikan, seperti resource yang kompatibel untuk metrik tertentu.

Mulai

Untuk menggunakan Validator Kueri Google Ads:

  1. Buka Query Validator.
  2. Masukkan kueri GAQL Anda.
  3. Klik tombol Validate Query.
  4. Tinjau pesan validasi yang muncul di bawah widget validator kueri. Pesan berhasil menunjukkan bahwa kueri valid. Jika tidak, pesan error yang menjelaskan masalah akan ditampilkan. Pesan error akan memandu Anda untuk memperbaiki kueri. Misalnya, error ketidaksesuaian kolom mungkin mencantumkan resource alternatif yang kompatibel dengan metrik atau segmen yang Anda coba kueri.

Untuk penjelasan yang lebih mendalam tentang konsep dan sintaksis GAQL, lihat panduan Bahasa Kueri Google Ads. Untuk membuat dan menguji kueri GAQL secara interaktif, Anda juga dapat menggunakan Pembuat Kueri dan APIs Explorer.