Google Ads API Geliştirici Asistanı (4.0.0 sürümü) genel bir chatbot değildir. Google Antigravity ve Claude Code aracı çerçeveleri üzerine kurulu, yapay zeka destekli reklam mühendisliği için özel bir görev kontrol sistemidir.
Doğal dilde soru-cevap ve işletmeye özgü bağlam
Asistan ile etkileşim kurmak için basit ve doğal bir dille sorular sorup istekte bulunabilirsiniz. Asistan, amacınızı analiz eder, resmi API şemalarına danışır ve net açıklamalar, üretime hazır kod veya canlı veriler sağlar:
- Doğal dil açıklamaları: Google Ads API kavramları, kaynak hiyerarşileri, raporlama metrikleri veya segmentasyon kuralları hakkında sorular sorarak net, kavramsal genel bakışlar ve mimari açıklamalar edinin.
- Hedeflenen kod oluşturma: Göreviniz uygulama gerektirdiğinde Asistan, programlama dilinize ve kullanım alanınıza göre uyarlanmış deyimsel, üretime hazır istemci kitaplığı kodu snippet'leri, değişiklik komut dosyaları veya GAQL sorguları sağlar.
- Sorun giderme ve hata teşhisi: API hata mesajlarını, gRPC durum kodlarını veya beklenmedik entegrasyon davranışlarını yapıştırın. Asistan, temel nedeni teşhis eder, sorunun neden oluştuğunu açıklar ve gerekli kod düzeltmelerini veya yapılandırma düzeltmelerini sağlar.
- Anlık raporlama: Hesap performansı verilerini ve kampanya metriklerini basit bir dille isteyin. Asistan, GAQL sorgularını doğrudan hesabınızda oluşturur, doğrular ve çalıştırır. Ardından, biçimlendirilmiş sonuçları terminalinizde gösterir veya CSV'ye aktarır.
- Kod tabanınızdaki işletmeye özgü bağlam:
--context_dirkurulum parametresini kullanarak kendi proje deponuzu ve kod tabanınızı kaydedin. Asistan, mevcut veri işlem hatlarınızı, yardımcı programlarınızı ve iş mantığınızı analiz ederek açıklamalarını, sorun giderme işlemlerini ve oluşturulan kodu dahili sistemlerinizle sorunsuz bir şekilde entegre olacak şekilde uyarlar.
Genel görünüm: Yüksek uyumlulukla ilgili sorunları çözme
Bu Asistan'ın çözdüğü temel sorunlar, bilişsel aşırı yüklenme ve teknik zorluklardır.
Google Ads API, mevcut en güçlü ancak aynı zamanda en karmaşık API'lerden biridir. Bu API'de katı sürüm oluşturma, benzersiz bir sorgu dili (GAQL), derinlemesine yerleştirilmiş protokol arabellek yapıları ve sıkı güvenlik şartları bulunur. Geliştiriciler genellikle zamanlarının önemli bir bölümünü gerçek iş mantığını oluşturmak yerine gRPC hatalarını ayıklayarak, alan uyumluluğunu arayarak ve linter sorunlarını düzelterek API ile mücadele ederek geçirir.
Asistan, 4.0.0 sürümünde bu sorunu, özel, test destekli becerilerle desteklenen ve yerleşik eğik çizgi komutları içeren bir modüler eklenti mimarisi sunarak çözüyor. Otomatik bir uzman ara yazılımı olarak işlev görür. Sürüm doğrulama, şema keşfi ve kod linting gibi zahmetli görevleri yöneterek geliştiricinin söz dizimi yerine amaç düzeyinde çalışmasına olanak tanır.
Tahminlere değil, resmi şemalara dayanır.
Standart büyük dil modelleri, yeni API sürümleri yayınlandıkça hızla eskiyen genel eğitim verilerine dayandıkları için alana özgü API'lerle genellikle zorlanır.
Google Ads API Geliştirici Asistanı, yerleştirilmiş Google Ads API mimari kurallarını dinamik ve yerel Protobuf şema incelemesiyle birleştirerek bu sorunu çözer:
- Deterministik doğrulama: Asistan, birden fazla gidiş dönüşte yinelemeli LLM tahminine güvenmek yerine, tek bir adımda alan uyumluluğunu, kaynak ilişkilerini, sıfır gösterim kurallarını ve tarih segmentasyonunu doğrulayan yerel 4 adımlı bir doğrulama ardışık düzeni çalıştırır.
- Sürüme göre doğru şema aramaları: Protobuf kaynak tanımlarını, veri türlerini ve enum değerlerini doğrudan etkin API sürümünün resmi API şemalarından inceleyerek tekrarlanan uzak meta veri sorgularını önler.
- Resmi istemci kitaplığı temeli: Kod oluşturma, Python, Java, PHP, .NET ve Ruby'deki resmi Google Ads istemci kitaplıklarına doğrudan dayanır.
Benzerlik: Uzmanlaşmış araştırma ve teşhis laboratuvarı
Asistanı, bir cerrah için yüksek teknolojili bir araştırma laboratuvarı olarak düşünebilirsiniz.
- Cerrah (geliştirici): Hangi işlemin yapılması gerektiğini bilirsiniz (ör. "Maksimum Performans'ın performansını analiz etmem gerekiyor").
- Laboratuvar ekipmanları (API): Bu ekipmanlar, ameliyatı gerçekleştirmek için gereken güçlü araçlardır ancak karmaşıktır ve tam kalibrasyon gerektirir.
- Laboratuvar asistanı (bu araç): Laboratuvar asistanı, hastaya dokunmadan önce özel beceriler ve yerleşik komutlar kullanarak:
- Kılavuzları inceleyin: En son API protokollerini otomatik olarak doğrular ve kaynak yapılarını anında inceler (
inspect_object//inspect-object). - Araçları önceden test edin: Sorgularınızda, hataları oluşmadan önce yakalamak için canlı API doğrulama (
validate_gaql//validate-gaql) kullanarak deterministik provalar yürütür. - Ortamı sterilize edin: Sistem hatalarına neden olmaması için kodunuzu katı linter işlem hatlarını (
rufflinting) kullanarak biçimlendirir ve temizler. - Hayati bulguları izleme: API istisnalarını izler ve çevrimdışı dönüşümler gibi karmaşık işlemler için gelişmiş teşhis iş akışları çalıştırır (
troubleshoot_conversions//troubleshoot-conversions). - Kavramları açıklama: Karmaşık kavramları günlük dilde ve gerçek hayattaki benzetmelerle (
/explain,/step-by-step,/assistant-tutorial) açıklar.
- Kılavuzları inceleyin: En son API protokollerini otomatik olarak doğrular ve kaynak yapılarını anında inceler (
Birbirine bağlılık: "Önce güvenlik" köprüsü
Asistan, projenizdeki dört farklı "dünyayı" birbirine bağlayan bir köprü görevi görür. Bu dört dünya, kontrol sözleşmeleri (AGENTS.md / CLAUDE.md) tarafından yönetilir:
- Kullanıcı bağlamı: Üst düzey hedeflerinizi dinler ve bunları teknik bir stratejiye dönüştürür.
- Yerel çalışma alanı: Proje dizininizde "gözler ve eller" bulunur. Mevcut kodu okuyabilir ve daha sonra kullanılmak üzere yeni kod yazabilir. Bunu yaparken sıkı bir izolasyon sağlar.
- Google Ads API: Yalnızca okunabilen raporlar oluşturmak ve hesabınızda test sorguları çalıştırmak için canlı API'ye bağlanır. Hızlı alan doğrulaması için yerel Protobuf şemalarını doğrudan inceler.
- Güvenlik görevlileri: Katı protokolleri takip etmek için tasarlanmıştır. Lint işlemi yapılmamış bir komut dosyasını çalıştırmanıza ve programatik doğrulama kontrolünden geçmemiş bir sorguyu göndermenize izin vermez.
Asistan'ın işlevleri
Basit bir ifadeyle, asistan sizin koruyucunuz ve hızlandırıcınızdır.
- Hataları önler: Kodu ve sorguları yürütülmeden önce etkin API şemalarına göre doğrulayarak söz dizimi ve uyumluluk hatalarının canlı API'ye ulaşmasını engeller.
- Haritayı bilir: Verilerin nerede bulunduğu ve nasıl verimli bir şekilde sorgulanacağı gibi Google Ads API'nin coğrafyasını anlar.
- Sıkıcı işleri otomatikleştirir: Standart istemci kitaplığı kodu yazar, raporları temiz terminal tabloları halinde biçimlendirir ve istemci kitaplığı tesisatını yönetir.
- Karmaşık iş akışlarında sorun giderme: Çevrimdışı dönüşüm yüklemeleriyle ilgili ayrıntılı teşhisler çalıştırır, MM hesabı hiyerarşilerini çözer ve Maksimum Performans listeleme filtreleri ile URL hariç tutmaları gibi karmaşık kampanya yapılarını yapılandırır.
- Canlı olarak geçici raporlar yayınlar: Performans verilerini düz İngilizce olarak isteyin. Asistan, GAQL sorgularını doğrudan hesabınızda oluşturur, doğrular ve çalıştırır. Biçimlendirilmiş sonuçları terminalinize yayınlar veya CSV olarak dışa aktarır.
- Güncel kalır: Etkin API sürümünün yerel Protobuf şemalarını ve belgelerini inceleyerek kullanımdan kaldırılmış alanlardan ve güncel olmayan kurallardan kaçınmanıza yardımcı olur.
Google Ads API Geliştirici Asistanı, "geliştiriciye karşı API" mücadelesini "geliştirici + yapay zeka" işbirliğine dönüştürerek güvenli, deyimsel ve mimari açıdan sağlam kodlar üretir.
Mimari ve performans (4.0.0 sürümü)
4.0.0 sürümü, asistanı bağımsız bir proje kurulumundan modern ve global bir eklenti mimarisine geçirir:
- Arka plan programı ek yükü yok: Beceriler ve teşhis komutları yalnızca çağrıldıklarında geçici olarak hafif alt işlemler şeklinde çalışır ve boşta olduklarında sistem kaynak kullanımı sıfıra düşer.
- Aşamalı bağlam açıklaması: Kurallar ve şemalar yalnızca etkin görevinizle alakalı olduğunda isteğe bağlı olarak yüklenir. Bu sayede, jeton tüketimi ve istem gecikmesi önemli ölçüde azalır.
- Daha az disk G/Ç: Eklenti ağacından gereksiz SDK dosyalarının kaldırılması, IDE indeksleyicilerinin, linter'ların ve dosya izleyicilerinin on binlerce kullanılmayan dosyayı taramasını engeller.
- Çok platformlu ana makine desteği: Linux, macOS ve Windows'da birleştirilmiş yükleme komut dosyalarıyla Google Antigravity ve Claude Code ortamlarında sorunsuz çalışır.
Sonraki adımlar
- Google Ads API Geliştirici Asistanı'nı yükleme ve yapılandırma
- Google Ads API aracı becerileri hakkında bilgi edinin
- Google Ads API MCP sunucusu hakkında bilgi edinin.