Google Ads API Gezgini

Google Ads API Gezgini, doğrudan tarayıcınızdan canlı API istekleri oluşturup göndermenize olanak tanıyan etkileşimli bir yürütme ortamıdır. Referans belgelerine yerleştirilmiş olan bu araç, OAuth 2.0 kimlik doğrulama ve JSON yükü biçimlendirmeyle ilgili karmaşık işlemleri yönetir. Böylece tek bir kod satırı yazmadan belirli hizmetleri ve yöntemleri test edebilirsiniz.

Avantajları

  • Kodsuz test: Yerel bir geliştirme ortamı oluşturmadan doğrudan dokümanlardan canlı API çağrıları (hem okuma hem de yazma) yapın.
  • Protokol keşfi: API'nin nasıl davrandığını anlamak için HTTP isteklerinin ve yanıtlarının tam yapısını görün.
  • Düşük sürtünmeli prototip oluşturma: Uygulamanızda mantık uygulamadan hemen önce uç nokta davranışını doğrulayın ve ham API yanıtlarını inceleyin.
  • Basitleştirilmiş kimlik doğrulama: Araç, OAuth 2.0 akışlarını otomatik olarak yöneterek kimlik bilgisi yönetimi yerine API isteğine odaklanmanıza olanak tanır.

Başlayın

  1. Belgelere gidin: Referans belgelere gidin ve test etmek istediğiniz hizmeti ve yöntemi (ör. GoogleAdsService/Search) seçin.
  2. Gezgin'i açın: Sayfanın sağ tarafındaki Bu yöntemi deneyin panelini bulun.
  3. İsteği yapılandırın:
    • customerId gibi gerekli İstek parametrelerini girin ve login-customer-id gibi isteğe bağlı HTTP başlıklarını sağlamak için Başlıklar'ı genişletin (yalnızca bir hesaba yönetici hesabı üzerinden erişirken gereklidir). Geliştirici jetonlarının (developer-token) 9 Eylül 2026'da kullanımdan kaldırıldığını ve API sunucuları tarafından yok sayıldığını unutmayın. Ancak formda istenirse yine de bir değer girebilirsiniz.
    • Yöntem, search veya mutate işlemleri gibi bir yük gerektiriyorsa etkileşimli JSON düzenleyiciyi kullanarak istek gövdesini tanımlayın.
  4. Yürüt: İsteği göndermek için Yürüt'ü tıklayın. Araç, tam HTTP isteğini ve API'den gelen canlı JSON yanıtını gösterir.

Temel özellikler

  • Canlı yürütme: Üretim veya test hesaplarınızda gerçek zamanlı search ve mutate işlemleri gerçekleştirin.
  • JSON yükü biçimlendirmesi: Gerekli alanları ve geçerli şema yapılarını vurgulayan araçla, istekler için karmaşık JSON nesnelerini etkileşimli olarak oluşturun.
  • Alan maskeleri: Kısmi kaynak güncellemelerinin pratikte nasıl davrandığını görmek için update_mask mantığını test edin.
  • Hata denetimi: Hata ayıklama sürecini hızlandırmak için ham yanıttaki ayrıntılı hata mesajlarını ve kodlarını (ör. QUERY_ERROR veya AUTHENTICATION_ERROR) görüntüleyin.
  • Kodu dışa aktarma: API Gezgini'nin genişletilmiş görünümünden curl komutlarını, ham HTTP isteklerini veya örnek JavaScript kodunu dışa aktarın.

Örnek kullanım alanları

  • Hesap ayarlarını denetleme: customer kaynağına yönelik bir GoogleAdsService/Search isteği yürüterek hesap düzeyindeki yapılandırmaları veya meta verileri hızlıca alın.
  • Mutasyonları test edin: Kodu üretime dağıtmadan önce kampanya oluşturma veya bütçe güncelleme işleminin başarılı olup olmadığını doğrulayın.
  • GAQL'de hata ayıklama: Google Ads Sorgu Dili (GAQL) dizesi çalıştırmak ve döndürülen JSON yapısının uygulamanızın beklentileriyle eşleştiğini doğrulamak için Explorer'ı kullanın.
  • Protokol doğrulama: Belirli bir API sürümü için gereken tam HTTP başlıklarını ve JSON iç içe yerleştirmesini inceleyin.