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. Dengan alat ini, Anda dapat memasukkan string kueri GAQL dan menerima masukan langsung tentang validitasnya, sehingga membantu mendeteksi error sintaksis, ketidakcocokan kolom, dan masalah lainnya sejak awal proses pengembangan.

Manfaat

  • Pencegahan error: Menemukan kueri yang tidak valid lebih 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 hubungan antar-resource.
  • Men-debug kueri: Memberikan pesan error spesifik 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 gagal.

Cara kerjanya

Validator Kueri mengurai kueri GAQL Anda berdasarkan skema Google Ads API dan aturan yang ditentukan dalam Bahasa Kueri Google Ads. API 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 masalah ditemukan, alat ini akan memberikan pesan error yang dirancang untuk membantu menunjukkan masalah, terkadang menawarkan saran perbaikan, seperti sumber daya 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 Query Validator. Pesan berhasil menunjukkan bahwa kueri valid. Jika tidak, pesan error yang menjelaskan masalah akan ditampilkan. Pesan error akan memandu Anda memperbaiki kueri. Misalnya, error ketidakcocokan kolom dapat mencantumkan resource alternatif yang kompatibel dengan metrik atau segmen yang coba Anda kueri.

Untuk penjelasan yang lebih mendalam tentang konsep dan validasi GAQL, Anda juga dapat melihat panduan video GAQL atau menggunakan Pembuat Kueri dan API Explorer.