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 dokümanlarına yerleştirilmiş olan bu araç, OAuth 2.0 kimlik doğrulama ve JSON yükü biçimlendirme işlemlerinin karmaşıklığını ortadan kaldırarak tek bir satır kod yazmadan belirli hizmetleri ve yöntemleri test etmenize olanak tanır.

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 belgelerine gidin ve test etmek istediğiniz hizmeti ve yöntemi (ör. GoogleAdsService/Search) seçin.
  2. Explorer'ı 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 üstbilgilerini sağlamak için Üstbilgiler'i 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 yoksayı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. Execute (Yürüt): İsteği göndermek için Execute'u (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çimlendirme: İstekler için karmaşık JSON nesnelerini etkileşimli olarak oluşturun. Araç, zorunlu alanları ve geçerli şema yapılarını vurgular.
  • Alan maskeleri: Kısmi kaynak güncellemelerinin pratikte nasıl davrandığını görmek için update_mask mantığını test edin.
  • Hata denetimi: 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.
  • 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 etme: 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'de hata ayıklama: Explorer'ı kullanarak bir Google Ads Sorgu Dili (GAQL) dizesi çalıştırın ve döndürülen JSON yapısının uygulamanızın beklentileriyle eşleştiğini doğrulayın.
  • Protokol doğrulama: Belirli bir API sürümü için gereken tam HTTP üstbilgilerini ve JSON iç içe yerleştirmeyi inceleyin.