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) langsung dari dokumentasi tanpa menyiapkan lingkungan pengembangan lokal.
  • Penemuan protokol: Lihat struktur pasti permintaan dan respons HTTP untuk memahami perilaku API.
  • Pembuatan prototipe tanpa hambatan: Verifikasi perilaku endpoint dan periksa respons API mentah segera 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.

Mulai

  1. Buka dokumentasi: Buka Dokumentasi referensi dan pilih layanan serta metode yang ingin Anda uji, seperti GoogleAdsService/Search.
  2. Buka Explorer: Cari panel Coba metode ini di sisi kanan halaman.
  3. Konfigurasi permintaan:
    • Masukkan Parameter permintaan yang diperlukan, seperti customerId, dan luaskan Header untuk memberikan header HTTP opsional seperti login-customer-id (hanya diperlukan saat mengakses akun melalui akun pengelola). Perhatikan bahwa token developer (developer-token) telah dihentikan pada 9 September 2026 dan diabaikan oleh server API, meskipun Anda masih dapat memasukkan nilai jika diminta oleh formulir.
    • Tentukan Isi permintaan menggunakan editor JSON interaktif jika metode memerlukan payload, seperti untuk operasi search atau mutate.
  4. Jalankan: Klik Jalankan untuk mengirim permintaan. Alat ini 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 yang diperlukan dan struktur skema yang valid.
  • Masker kolom: Uji logika update_mask untuk melihat perilaku update resource parsial dalam praktiknya.
  • Pemeriksaan error: Lihat pesan dan kode error mendetail (seperti QUERY_ERROR atau AUTHENTICATION_ERROR) dalam respons mentah untuk memfasilitasi proses debug yang lebih cepat.
  • Ekspor kode: Ekspor perintah curl, permintaan HTTP mentah, atau contoh kode JavaScript dari tampilan yang diperluas dari API Explorer.

Contoh kasus penggunaan

  • Setelan akun audit: Ambil konfigurasi tingkat akun atau metadata dengan cepat dengan menjalankan permintaan GoogleAdsService/Search terhadap resource customer.
  • Uji mutasi: Verifikasi keberhasilan pembuatan kampanye atau update anggaran sebelum men-deploy kode ke produksi.
  • Debug GAQL: Gunakan Explorer untuk menjalankan string Google Ads Query Language (GAQL) dan verifikasi bahwa struktur JSON yang ditampilkan sesuai dengan ekspektasi aplikasi Anda.
  • Verifikasi protokol: Periksa header HTTP dan nesting JSON yang diperlukan untuk versi API tertentu.