Google Ads API Geliştirici Asistanı 3.0.0 sürümü kullanıma sunuldu

10 Haziran 2026, Çarşamba

Google Ads API Developer Assistant'ın 3.0.0 sürümünün yayınlandığını duyurmaktan mutluluk duyuyoruz. Bu önemli sürüm, Asistan'ın gelişiminde önemli bir dönüm noktasıdır. Mimari modernizasyona, daha fazla güvenilirliğe ve daha modüler bir tasarıma odaklanır.

Bu sürümle birlikte Asistan'ı Google Antigravity temsilci çerçevesine taşıyor ve beceri tabanlı bir mimariye geçiyoruz. Bu değişiklikler, Asistan'ı daha sağlam ve bakımı daha kolay hale getirirken jeton kullanımını azaltır.

3.0.0 sürümündeki yenilikler

1. Antigravity çerçevesi tarafından desteklenir

Google Ads API Geliştirici Asistanı, gemini-cli sürümünden Antigravity aracı çerçevesine (v3.0.0) taşındı. Bu temel çerçeve yükseltmesi, daha yapılandırılmış ve güvenilir bir yürütme ortamı sağlar. Bununla birlikte, projenin dizin ve dosya yapısı Antigravity'ye tamamen hazır olacak şekilde güncellendi.

gemini-cli desteği, bu Google blog duyurusunda ayrıntılı olarak açıklandığı üzere 18 Haziran 2026'da sona erecek.

2. Modüler, beceriye dayalı bir mimari

Asistan'ın temel özelliklerini Beceriler'e taşıdık. Asistan artık bir bağlam dosyasındaki geniş, yapılandırılmamış talimatlara güvenmek yerine, gerektiğinde özel, test destekli araç dizinlerini (Beceriler) dinamik olarak yükler. Bu sayede "halüsinasyonlar" önemli ölçüde azalır ve görevlerin kesin, doğrulanmış prosedürler kullanılarak yürütülmesi sağlanır.

Bu modüler geçişteki önemli güncellemeler şunlardır:

  • GAQL validation (validate_gaql): Özel bir beceriye taşındı. Artık tarih segmentleri, click_view tek günlük filtreler ve change_status sınırları için gelişmiş statik sorgu kontrolleri içeriyor.
  • Dönüşümlerle ilgili sorunları giderme (troubleshoot_conversions): Eski conversions_support_package aracının yerini alır. Bu araç, tüm dönüşüm sorun giderme ve yükleme özeti komut dosyalarını ve testlerini tek bir uyumlu beceri dizininde birleştirir.
  • Yapılandırılmış komutlar (explain ve step_by_step): Açıklamalar için tutarlı ve yapılandırılmış düzenler uygulamak amacıyla becerilere dönüştürüldü.
  • Yeni hesap eşleme (get_cids_under_mcc): Yönetici Hesabı (MM) altındaki tüm alt hesapları almak için yeni bir beceri.
  • Yeni nesne denetimi (inspect_object): Asistan'ın her zaman doğru yapıları kullanmasını sağlamak için Protobuf mesajlarını ve Enum'ları anında dinamik olarak arayan yeni bir beceri.
  • Yeni Maksimum Performans listeleme filtresi (pmax_listing_filter): Maksimum Performans kampanyaları için listeleme grubu web sayfası hariç tutma ağacı değişikliklerini standartlaştıran yeni bir beceri.

3. Daha fazla tutarlılık ve titizlik

Yüksek kaliteli kod oluşturma ve sorgu doğrulama sağlamak için daha katı kurallar ve şartlar getirdik:

  • Açık API sürümü oluşturma: get_cids_under_mcc, validate_gaql ve troubleshoot_conversions gibi kritik beceriler artık açık bir api_version bağımsız değişkeni gerektiriyor. Bu sayede belirsizlik ortadan kalkıyor.
  • Katı GAQL kuralları:
    • GAQL sorgularında SQL topla işlevlerinin (ör. SUM, COUNT ve AVG) kullanımı desteklenmediğinden AGENTS.md için bu işlevlerin kullanımını engelleyen bir kural eklendi.
    • Asistan'ın güncel belgeleri kullandığından emin olmak için öncelikle mevcut API sürümüne ait Google Ads API Geliştirici sitesi sürüm notlarını kontrol etme kuralı eklendi.
    • Basitleştirilmiş yapılandırma: AGENTS.md basitleştirildi ve daha küçük bir ilk bağlam penceresi elde edildi. Yinelenen dönüşüm belgeleri, programatik beceriler lehine kaldırıldı.

4. Geliştirici Deneyimi (DX) iyileştirmeleri

Geliştirme döngünüzü daha hızlı ve sorunsuz hale getirmek için kullanım kolaylığı sağlayan çeşitli iyileştirmeler yaptık:

  • Kalıcı sanal ortam (.venv): Sanal ortam artık oturumun sonunda silinmez. Asistan, başlangıçta sisteminizin Python sürümünü kontrol eder ve yalnızca daha yeni bir Python sürümü varsa .venv öğesini yeniden oluşturur.
  • Akıllı API sürümü önbelleğe alma: Asistan artık mevcut Google Ads API sürümünü 19 saatlik bir TTL ile önbelleğe alarak gereksiz ağ kontrollerini önler ve başlangıç süresini kısaltır.
  • Kalıcı günlüklerle daha iyi hata ayıklama: Günlük mesajları artık tarih ve saat damgaları içeriyor. Günlük dosyası .agents/ dizinine yazılır ve her çalıştırmada sıfırlanmaz. Böylece sorun giderme için geçmiş korunur.

Neden yükseltmelisiniz?

3.0.0 sürümüne yükseltme, öncelikle güvenilirlik ve yapı ile ilgilidir. Antigravity çerçevesine geçerek ve özellikleri Beceriler halinde modülerleştirerek Asistan'ı daha öngörülebilir ve kaynak açısından verimli hale getirdik.

Daha hızlı başlatma, daha güvenilir GAQL doğrulaması ve daha sağlam bir sorun giderme deneyimi istiyorsanız v3.0.0'a yükseltmenizi öneririz.

Başlayın

İlk kurulum

  1. Antigravity CLI'yı yükleyin: https://antigravity.google/ adresindeki talimatları uygulayın.
  2. Asistan'ı klonlama: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Yükleme komut dosyasını çalıştırma:
    • Linux/macOS: ./install.sh komutunu çalıştırın (varsayılan olarak Python desteği kullanılır, diğer diller için --php veya --ruby gibi işaretleri kullanın).
    • Windows: PowerShell'i açın ve .\install.ps1 komutunu çalıştırın.

v2.x'ten yükseltme

  1. saved/ dizinindeki özel kodları veya verileri proje dizini dışında güvenli bir konuma kopyalayın.
  2. Asistan'ın yerel kopyasını silin.
  3. Kod deposunu klonlayın:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Yeni Antigravity ortamını ilk kullanıma hazırlamak için yükleme komut dosyasını (install.sh veya install.ps1) çalıştırın.

Bob Hancock, Google Ads API Ekibi

Etiketler: google-ads-api, release