Google Ads API Developer Assistant 2.0 sürümüyle tanışın

26 Şubat 2026, Perşembe

Bu önemli güncelleme, Asistan'ı güçlü bir kod oluşturma aracından Google Ads geliştiricileri için proaktif bir sorun giderme ve otomasyon iş ortağına dönüştürüyor. 1.6.0 sürümümüzden bu yana geri bildirimlerinizi dinledik ve API geliştirmenin en zorlu kısımlarına odaklandık: teşhis, tutarlılık ve kurulum.

2.0 sürümündeki yenilikler

1. Daha Kolay Kurulum ve Bakım

Çok dilli bir geliştirme ortamı oluşturmak zor olmamalıdır.

  • Tek komutla kurulum: Pip, Composer ve Bundler bağımlılıklarını tek seferde yönetmek için install.sh veya install.ps1 ile yeni --install-deps işaretini kullanın.
  • Birleştirilmiş dizin yapısı: Oluşturulan tüm kodlarınız, CSV dışa aktarma işlemleriniz ve teşhis raporlarınız artık her çıkış türü için alt dizinleri olan tek bir saved/ dizini altında düzenlenir.
  • Tek komutla güncelleme: API'nin ve istemci kitaplıklarının yeni bir sürümü yayınlandığında en yeni sürümle çalışmak için update.sh komutunu çalıştırmanız gerekir. Bağlamınıza başka istemci kitaplıkları eklemek için update.sh komutunu da kullanabilirsiniz.

2. Temsilci tabanlı dönüşüm sorunlarını giderme

Çevrimdışı dönüşüm izleme, Google Ads API'nin en güçlü ancak en karmaşık özelliklerinden biridir. Bir dönüşümün neden ilişkilendirilmediğini bulmak için hata ayıklama yapmak, zaman alan manuel bir işlem olabilir.

2.0 sürümünde, özel bir Dönüşüm Sorun Giderme ve Teşhis paketini kullanıma sunduk.

  • Yeni komut dosyası: api_examples/collect_conversions_troubleshooting_data.py
  • Yeni komut: /conversions_support_data

Komut dosyası, dönüşüm sorunlarını gidermek için standart raporları çalıştırır ve sorunlarınızı gidermesi için Asistan'a bağlam sağlar.

Bu komut, Asistan dönüşüm sorununuzu analiz edip çözmeye çalıştıktan sonra en faydalı olur. Bu mümkün değilse ve destek ekibiyle iletişime geçmeniz gerekiyorsa bu komut, müşteri ayarlarınızı, dönüşüm işlemlerinizi ve yükleme özetlerinizi analiz ederek önceden gerçekleştirilen analize dayalı yapılandırılmış bir teşhis raporu oluşturur. Hatta "sağlıksız" durumları ve yüksek hata oranlarını otomatik olarak tanımlayarak sizi saatlerce günlük inceleme zahmetinden kurtarır. Sonuçları bir metin dosyasına kaydeder. Destek kaydı oluşturmanız gerekirse bu dosyayı destek isteğine ekleyebilirsiniz.

3. En yeni API (v23) için geliştirildi

2.0 sürümü, Google Ads API v23'ü tam olarak destekler. Tüm etkileşimli örneklerimiz güncellendi ve asistanın dahili bağlamı artık en yeni kaynaklar ve alanlar için optimize edildi. Böylece, oluşturduğunuz kodun üretime hazır olması sağlandı.

4. Oturum Kancaları ile Sorunsuz Otomasyon

İş akışınızı gerçekten sorunsuz hale getirmek için SessionStart ve SessionEnd kancalarını ekledik.

  • Otomatik yapılandırma: Asistan artık oturumun başında $HOME dizininizdeki yapılandırma dosyanızı otomatik olarak bulabilir. Bu işlem, dosyayı proje dizininizdeki config alt dizinine kopyalar. Python, Gemini'ın API'yi sorgulamak için tercih ettiği dildir. Başka bir dil kullanıyorsanız yapılandırma dosyanızı okur ve sorguları için yapılandırmada geçici bir google-ads.yaml dosyası oluşturur ancak tercih ettiğiniz dilin kodunda yanıt vermeye devam eder.
  • Otomatik temizleme: Geçici yapılandırmalar, çıkış yaptığınızda güvenli bir şekilde silinir. Böylece çalışma alanınız temiz, kimlik bilgileriniz güvende kalır.

5. Daha akıllı GAQL doğrulaması

Karmaşık GAQL sorguları oluşturmak artık her zamankinden daha kolay. Tarih segmentlerinin ve sınırlı aralık şartlarının daha iyi işlenmesi de dahil olmak üzere en son API uç durumları için katı doğrulama kurallarıyla GEMINI.md ve conversions/GEMINI.md güncellendi. Asistan artık sorguyu yürütmeden önce mantık hatalarını yakalar.

6. Beceri

Becerileri, mini eklentiler veya "davranış şablonları" olarak düşünebilirsiniz. Genel bağlam (ör. GEMINI.md dosyanız) arka plan bilgisi sağlarken, bir beceri yalnızca bu uzantının mevcut sürümünü alma gibi karmaşık ve prosedürel bir görevi gerçekleştirmesi gerektiğinde yapay zekanın beynine "yüklenir". Beceriyi doğrudan çalıştırmazsınız. Gemini, ne zaman ihtiyaç duyacağına kendisi karar verir.

Hâlâ deneysel bir özellik olsa da oturum başlatma ve temizleme için kancaları kullanımımızı tamamlamak amacıyla bu sürüme bir tane ekledik.

Neden yükseltme yapmalısınız?

1.6.0 sürümünden 2.0.0 sürümüne geçiş, yalnızca yeni özelliklerle ilgili değil, aynı zamanda güvenilirlikle de ilgilidir. 2.0 sürümü, derin API bilgisini otomatik teşhis araçlarıyla entegre ederek API entegrasyonunu genellikle yavaşlatan "deneme yanılma" döngüsünü azaltır.

İster dönüşüm yüklemelerinde hata ayıklıyor ister karmaşık raporlama ardışık düzenleri oluşturuyor olun, v2.0 size daha hızlı ve daha güvenli çalışmanızı sağlayacak araçlar sunar.

Başlarken

İlk kurulum

Önceki bir sürümden yükseltme

  • saved_code/ ve saved_csv/ dosyalarındaki özel kodları güvenli bir yere kopyalayın.
  • Proje dizininizi ve tüm alt dizinleri ve dosyaları silerek Google Ads API Developer Assistant'ın yerel kopyasını silin.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Proje dizininde, uzantıyı ve istemci kitaplıklarını yüklemek için install.sh veya install.ps1 komutunu çalıştırın.

Bob Hancock, Google Ads API Ekibi

Etiketler: google-ads-api, release