Google Ads API Explorer

Google Ads API Explorer adalah lingkungan eksekusi interaktif yang memungkinkan Anda membuat dan mengirim permintaan API langsung dari browser. Disematkan dalam dokumentasi referensi, alat ini menangani kompleksitas autentikasi OAuth 2.0 dan pemformatan payload JSON, sehingga Anda dapat menguji layanan dan metode tertentu tanpa menulis satu baris kode pun.

Manfaat

  • Pengujian tanpa kode: Jalankan panggilan API langsung (baca dan tulis) dari dokumentasi tanpa menyiapkan lingkungan pengembangan lokal.
  • Penemuan protokol: Lihat struktur persis permintaan dan respons HTTP untuk memahami perilaku API.
  • Pembuatan prototipe dengan gesekan rendah: Verifikasi perilaku endpoint dan periksa respons API mentah secara instan sebelum menerapkan logika di aplikasi Anda.
  • Autentikasi yang disederhanakan: Alat ini mengelola alur OAuth 2.0 secara otomatis, sehingga Anda dapat berfokus pada permintaan API, bukan pengelolaan kredensial.

Memulai

  1. Buka dokumentasi: Buka Dokumentasi referensi dan pilih layanan serta metode yang ingin Anda uji, seperti GoogleAdsService/Search.
  2. Buka Explorer: Cari panel "Coba" di sisi kanan halaman.
  3. Konfigurasi permintaan:
    • Masukkan Parameter permintaan yang diperlukan, seperti developer-token dan login-customer-id.
    • Tentukan Isi permintaan menggunakan editor JSON interaktif jika metode memerlukan payload, seperti untuk operasi `mutate`.
  4. Jalankan: Klik Jalankan untuk mengirim permintaan. Alat ini akan menampilkan permintaan HTTP lengkap dan respons JSON langsung dari API.

Fitur utama

  • Eksekusi langsung: Lakukan operasi search dan mutate real-time terhadap akun produksi atau pengujian Anda.
  • Pemformatan payload JSON: Buat objek JSON kompleks untuk permintaan secara interaktif, dengan alat yang menandai kolom wajib diisi dan struktur skema yang valid.
  • Masker kolom: Uji logika update_mask untuk melihat perilaku update resource sebagian dalam praktiknya.
  • Pemeriksaan error: Lihat pesan dan kode error mendetail (seperti QUERY_ERROR atau AUTHENTICATION_ERROR) dalam respons mentah untuk memfasilitasi pen-debug-an yang lebih cepat.
  • Ekspor kode: Ekspor perintah curl, permintaan HTTP mentah, atau contoh kode JavaScript dari tampilan yang diperluas di API Explorer.

Contoh kasus penggunaan

  • Setelan akun audit: Ambil konfigurasi atau metadata tingkat akun dengan cepat dengan menjalankan permintaan get atau search.
  • Uji mutasi: Verifikasi keberhasilan pembuatan kampanye atau pembaruan anggaran sebelum men-deploy kode ke produksi.
  • Men-debug GAQL: Gunakan Explorer untuk menjalankan string Google Ads Query Language (GAQL) dan verifikasi bahwa struktur JSON yang ditampilkan cocok dengan ekspektasi aplikasi Anda.
  • Verifikasi protokol: Periksa header HTTP dan nesting JSON yang tepat yang diperlukan untuk versi API tertentu.