Google Ads API Developer Assistant v4.0.0

25 Ağustos 2026, Salı

Google Ads API Developer Assistant'ın önemli bir sürümü kullanıma sunuldu. Bu sürümde asistan, bağımsız bir proje kurulumundan özel Google Ads API özelliklerini doğrudan yapay zeka ajanı iş akışlarına getirmek için tasarlanmış birleşik bir eklenti mimarisine geçiyor.


Bu nedir?

Google Ads API Geliştirici Asistanı, Antigravity ve Claude Code gibi yapay zeka kodlama ortamlarına Google Ads alanıyla ilgili kapsamlı uzmanlık bilgisi sağlar. Yapay zeka asistanınızı özel araçlar ve güvenlik önlemleriyle donatır. İşlevler şunlardır:

  • Doğal kod oluşturma: Python, Java, PHP, .NET ve Ruby dillerinde test edilmiş, en iyi uygulamalara uygun entegrasyon kodu oluşturun.
  • GAQL sorgularını doğrulama: Sorguları çalıştırmadan önce söz dizimini, alan uyumluluğunu, tarih segmentasyonunu ve sıfır gösterim kurallarını otomatik olarak doğrular.
  • Protobuf şemalarını inceleme: GAQL sorgu alanlarının geçerli olduğundan emin olmak için herhangi bir etkin Google Ads API sürümüne ait kaynak alanlarını, veri türlerini ve enum tanımlarını isteğe bağlı olarak keşfetme.
  • API sorunlarını giderme: Çevrimdışı dönüşüm yükleme hatalarını teşhis edin, yönetici hesabı hiyerarşilerinde gezinin ve Maksimum Performans listeleme filtreleri oluşturun. "Hesabımdaki sorunlu reklamların tümünü göster ve bunları nasıl düzeltebileceğimi öner." gibi doğal dilde sorular sorabilirsiniz.
  • API sorularını yanıtlama: Asistan, yerleşik Google Ads API mimari kurallarını dinamik, yerel Protobuf şema denetimiyle birleştirerek soruları yanıtlar. Bu sayede, sürüme uygun rehberlik ve doğrulanmış kod snippet'leri sunar. Yalnızca genel model eğitimine güvenmek yerine yanıtlarını doğrudan resmi API tanımlarına ve istemci kitaplığı kaynak koduna dayandırır. "Paylaşılan kitaplık nedir ve nasıl kullanılır?" gibi bir soru buna örnek verilebilir.
  • Özel raporlama: Performans verilerini basit bir dille sorabilirsiniz. Asistan, gerekli GAQL sorgularını doğrudan Google Ads hesabınızda anında oluşturur, doğrular ve çalıştırır. Canlı sonuçları temiz ve biçimlendirilmiş tablolar halinde sohbetinize aktararak anlık raporlama ve metrik incelemelerini kolaylaştırır. Sonuçları kaydetmek istiyorsanız "Sonuçları <dizininiz> içinde CSV dosyası olarak kaydet" diyerek kaydedebilir ve analiz için bir e-tabloya yükleyebilirsiniz.


Antigravity ve Claude Code desteği

Bu sürümde çift platform desteği sunulmaktadır:

  • Antigravity: Global ve Workspace eklenti kaydıyla Antigravity geliştirici ortamları için yerel destek.
  • Claude Code: Özel eğik çizgi komutları (ör. /validate-gaql, /inspect-object, /troubleshoot-conversions ve /get-cids) dahil olmak üzere Claude Code CLI eklenti sistemiyle tam entegrasyon.

Üç platformda da tutarlı yaşam döngüsü yönetimi sağlamak için Linux, macOS (bash) ve Windows (PowerShell) için birleştirilmiş yükleme komut dosyaları kullanılabilir.


Artırılmış performans

  • Daha az jeton tüketimi: Kuralların ve şemaların aşamalı olarak açıklanması, yalnızca belirli bir görev için gereken bağlamı yükleyerek istem jetonu ek yükünü azaltır.
  • Daha hızlı yanıt süreleri: İsteğe bağlı beceri yürütme ve hedeflenen komut yönlendirme, görevlerin uçtan uca daha hızlı tamamlanmasını sağlar.
  • Daha düşük CPU kullanımı: Kolaylaştırılmış yürütme ardışık düzenleri, geliştirme oturumları sırasında arka plan işlemi ek yükünü ortadan kaldırır.
  • Daha az disk G/Ç: Eklenti ağacındaki gereksiz dosyaların sayısını azaltmak; dosya izleyicilerin, linter'ların ve IDE dizinleyicilerin on binlerce kullanılmayan protobuf/SDK dosyasını taramasını önler.
  • Daha düşük bellek (RAM) kullanımı ve sıfır arka plan programı ek yükü: Beceriler ve komutlar artık yalnızca çağrıldığında hızlı alt işlemler olarak geçici bir şekilde çalışır. Böylece, boşta kaldığında sistem kaynağı kullanımı sıfıra düşer.
  • Önbelleğe alınmış API sürümü ve Protobuf şema çözünürlüğü: Asistan, standart alanları, kaynakları ve enum'ları incelerken tekrarlayan uzak meta veri veya yansıma API çağrıları yapmaktan kaçınır.
  • Deterministik komut yürütme ve çok adımlı LLM akıl yürütme: LLM'nin GAQL söz dizimini 3-4 gidiş dönüşte tahmin etmesi veya yinelemeli olarak hata ayıklaması yerine, yerel doğrulayıcı alanları, kaynakları, sıfır gösterimli metrikleri ve tarih ifadelerini tek bir adımda kontrol eder.


Modern bir eklenti mimarisi üzerine inşa edilmiş önemli bir sürüm

Bu, önceki sürümlerle uyumlu olmayan önemli bir sürümdür. Önceki sürümler, yerel bir çalışma alanı proje yapısına dayanıyordu. Bu sürüm, genel olarak kullanılabilir olacak şekilde yüklenen standart bir eklenti mimarisi üzerine kurulmuştur.

Kuralları, becerileri ve teşhis komutlarını bağımsız bir eklenti paketinde modüler hale getirmek, geliştiricilerin asistanı birden fazla ortamda ve projede yüklemesine, güncellemesine ve yönetmesine olanak tanır.

Eklenti mimarisiyle ilgili teknik ayrıntılar için README.md dosyasına bakın.


Başlarken

Bu sürümdeki mimari değişiklikler nedeniyle, yüklemeden önce dokümanları inceleyin:

  1. Ön koşullar ve ortam hazırlığı için README_BEFORE_INSTALLATION.md dosyasını okuyun.
  2. README.md dosyasındaki yükleme talimatlarını uygulayın.


Geri bildirimlerinizi bizimle paylaşın

Anket formunu kullanarak geri bildiriminizi paylaşabilir, sorunları bildirebilir ve özellik önerebilirsiniz:

👉 Geri bildiriminizi gönderin


Etiketler: google-ads-api, release