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 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 çalıştığını anlamak için HTTP isteklerinin ve yanıtlarının tam yapısını görün.
  • Kolay prototip oluşturma: Uç nokta davranışını doğrulayın ve uygulamanızda mantık uygulamadan hemen önce ham API yanıtlarını 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şlayın

  1. Belgelere gidin: Referans belgelerine gidin ve test etmek istediğiniz hizmeti ve yöntemi (ör. GoogleAdsService/Search) seçin.
  2. Gezgin'i açın: Sayfanın sağ tarafında Bu yöntemi deneyin panelini bulun.
  3. İsteği yapılandırın:
    • customerId gibi gerekli istek parametrelerini girin ve login-customer-id gibi isteğe bağlı HTTP üstbilgilerini sağlamak için üstbilgileri 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 form tarafından istendiğinde değer girebilmenize rağmen API sunucuları tarafından yoksayıldığını unutmayın.
    • Yöntem, search veya mutate işlemleri gibi bir yük gerektiriyorsa etkileşimli JSON düzenleyiciyi kullanarak İstek 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: 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 ham yanıttaki ayrıntılı hata mesajlarını ve kodlarını (ör. QUERY_ERROR veya AUTHENTICATION_ERROR) 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: customer kaynağına karşı 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 HTTP başlıklarını ve JSON iç içe yerleştirme işlemlerini inceleyin.