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ı

  • Kodsız test: Yerel geliştirme ortamı oluşturmadan doğrudan dokümanlardan canlı API çağrıları (hem okuma hem de yazma) yürütün.
  • Protokol keşfi: API'nin nasıl çalıştığını anlamak için HTTP isteklerinin ve yanıtlarının tam yapısını inceleyin.
  • Kolay prototip oluşturma: Uygulamanızda mantık uygulamadan önce uç nokta davranışını doğrulayın ve ham API yanıtlarını anında inceleyin.
  • Basitleştirilmiş kimlik doğrulama: Araç, OAuth 2.0 akışlarını otomatik olarak yönetir. Böylece, kimlik bilgisi yönetimi yerine API isteğine odaklanabilirsiniz.

Başlarken

  1. Belgelere gitme: Referans belgelerine gidin ve test etmek istediğiniz hizmeti ve yöntemi (ör. GoogleAdsService/Search) seçin.
  2. Explorer'ı açın: Sayfanın sağ tarafında "Deneyin!" panelini bulun.
  3. İsteği yapılandırın:
    • Gerekli istek parametrelerini girin (ör. developer-token ve login-customer-id).
    • Yöntem, `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ç, HTTP isteğinin tamamını 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: Kaynakların kısmi güncellemelerinin pratikte nasıl çalıştığını görmek için update_mask mantığını test edin.
  • Hata inceleme: Daha hızlı hata ayıklama için ayrıntılı hata mesajlarını ve kodlarını (ör. QUERY_ERROR veya AUTHENTICATION_ERROR) ham yanıtta görüntüleyin.
  • Kod 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: get veya search isteği yürüterek hesap düzeyindeki yapılandırmaları ya da meta verileri hızlıca alın.
  • Test mutasyonları: Kodu üretime dağıtmadan önce kampanya oluşturma veya bütçe güncelleme işleminin başarılı olduğunu doğrulayın.
  • GAQL'yi hata ayıklama: Bir 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 HTTP üstbilgilerini ve JSON iç içe yerleştirme işlemlerini inceleyin.