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, API Explorer 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 persis permintaan dan respons HTTP untuk memahami perilaku API.
  • Pembuatan prototipe yang mudah: Verifikasi perilaku endpoint dan periksa respons API mentah segera sebelum menerapkan logika dalam 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, lalu pilih layanan dan metode yang ingin Anda uji, seperti GoogleAdsService/Search.
  2. Buka Explorer: Cari panel Coba metode ini di sisi kanan halaman.
  3. Konfigurasikan permintaan:
    • Masukkan Parameter permintaan yang diperlukan, seperti customerId, dan perluas 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. Execute: Klik Execute 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 pada akun produksi atau pengujian Anda.
  • Pemformatan payload JSON: Membangun objek JSON yang kompleks secara interaktif untuk permintaan, dengan alat yang menandai kolom wajib diisi dan struktur skema yang valid.
  • Field mask: 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 kode JavaScript contoh dari tampilan yang diperluas di APIs Explorer.

Contoh kasus penggunaan

  • Mengaudit setelan akun: Ambil konfigurasi atau metadata tingkat akun dengan cepat dengan menjalankan permintaan GoogleAdsService/Search terhadap resource customer.
  • Menguji mutasi: Verifikasi keberhasilan pembuatan kampanye atau pembaruan anggaran sebelum men-deploy kode ke produksi.
  • Men-debug GAQL: Gunakan Explorer untuk menjalankan string Bahasa Kueri Google Ads (GAQL) dan verifikasi bahwa struktur JSON yang ditampilkan sesuai dengan ekspektasi aplikasi Anda.
  • Verifikasi protokol: Periksa header HTTP dan bertingkat JSON yang tepat yang diperlukan untuk versi API tertentu.