Google Ads API Developer Assistant (v4.0.0) genel bir chatbot değildir. Google Antigravity ve Claude Code temsilci çerçeveleri üzerine inşa edilen bu sistem, 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'la etkileşim kurmak için sorularınızı ve isteklerinizi basit ve doğal bir dille ifade edebilirsiniz. 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ış, kullanıma hazır istemci kitaplığı kod snippet'leri, mutasyon 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, sorunun temel nedenini 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ızdan işletmeye özgü bağlam:
--context_dirkurulum parametresini kullanarak kendi proje deponuzu ve kod tabanınızı kaydedin. Asistan; mevcut veri ardışık düzenlerinizi, yardımcı araçları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 sorun, bilişsel aşırı yük ve teknik zahmettir.
Google Ads API, en güçlü API'lerden biri olmakla birlikte en karmaşık API'lerden biridir. Sıkı sürüm oluşturma, benzersiz bir sorgu dili (GAQL), derinlemesine iç içe yerleştirilmiş protokol arabelleği yapıları ve katı güvenlik şartları vardır. 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 dayalıdır.
Standart büyük dil modelleri, genel eğitim verilerine dayandığı için alana özgü API'lerde genellikle zorlanır. Bu veriler, yeni API sürümleri yayınlandıkça hızla güncelliğini yitirir.
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:
- Belirleyici 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 işlem hattı çalıştırır.
- Sürüm açısından doğru şema aramaları: Etkin API sürümü için doğrudan resmi API şemalarından Protobuf kaynak tanımlarını, veri türlerini ve enum değerlerini 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 dayalıdır.
Analoji: 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 ekipmanı (API): Bunlar, ameliyatı gerçekleştirmek için gereken güçlü araçlardır ancak karmaşıktır ve hassas kalibrasyon gerektirir.
- Laboratuvar asistanı (bu araç): Laboratuvar asistanı, hastaya dokunmadan önce özel beceriler ve yerleşik komutlar kullanarak şunları yapar:
- 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 etme: Hataları gerçekleşmeden önce yakalamak için canlı API doğrulaması (
validate_gaql//validate-gaql) kullanarak sorgularınızda deterministik denemeler yapar. - Ortamı sterilize edin: Sistem hatalarına neden olmaması için kodunuzu katı linter işlem hatlarını (
rufflinting) kullanarak biçimlendirir ve temizler. - Önemli metrikleri izleme: API istisnalarını izler ve çevrimdışı dönüşümler (
troubleshoot_conversions//troubleshoot-conversions) gibi karmaşık işlemler için gelişmiş teşhis iş akışları çalıştırır. - 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ünya" arasında köprü görevi görür. Bu dünyalar, kontrol sözleşmeleriyle (AGENTS.md / CLAUDE.md) 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özleri ve elleri" vardır. Mevcut kodu okuyabilir ve daha sonra kullanılmak üzere yeni kod yazabilir. Bu sırada katı bir izolasyon sağlar.
- Google Ads API: Salt okunur raporları çalıştırmak ve hesabınızda sorguları test etmek 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ı protokollere uymak üzere programlanmıştır. Lint işlemi yapılmamışsa komut dosyası çalıştırmanıza, programatik doğrulama kontrolünden geçmemişse sorgu göndermenize izin verilmez.
Asistan'ın yaptıkları
Basitçe ifade etmek gerekirse asistan, koruyucunuz ve hızlandırıcınızdır.
- Hataları önler: Kodları ve sorguları yürütmeden önce etkin API şemalarına göre doğrular. Böylece, söz dizimi ve uyumluluk hatalarını canlı API'ye ulaşmadan durdurur.
- Haritayı bilir: Google Ads API'nin coğrafyasını (verilerin nerede bulunduğunu ve verileri verimli bir şekilde nasıl sorgulayacağı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ındaki sorunları giderir: Çevrimdışı dönüşüm yüklemelerinde derin teşhisler çalıştırır, yönetici hesabı hiyerarşilerini çözer ve Maksimum Performans listeleme filtreleri ile URL hariç tutma işlemleri 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ü için yerel Protobuf şemalarını ve belgelerini inceleyerek, desteği sonlandırılmış alanlardan ve güncel olmayan kurallardan kaçınmanıza yardımcı olur.
Google Ads API Developer Assistant, "geliştirici ile API" arasındaki mücadeleyi, güvenli, deyimsel ve mimari açıdan sağlam kodlar üreten bir "geliştirici + yapay zeka" işbirliğine dönüştürür.
Mimari ve performans (v4.0.0)
4.0.0 sürümü, asistanı bağımsız bir proje kurulumundan modern ve küresel bir eklenti mimarisine geçirir:
- Daemon'da sıfır ek yük: Beceriler ve teşhis komutları yalnızca çağrıldığında geçici olarak hafif alt işlemler şeklinde çalışır ve boşta kaldığında sistem kaynağı kullanımı sıfıra düşer.
- Kademeli bağlam paylaşımı: Kurallar ve şemalar yalnızca etkin görevinizle ilgili 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.
- Çoklu platform ana makine desteği: Linux, macOS ve Windows'ta birleştirilmiş yükleme komut dosyalarıyla Google Antigravity ve Claude Code ortamlarında sorunsuz çalışır.
Sonraki adımlar
- Google Ads API Developer Assistant'ı yükleme ve yapılandırma
- Google Ads API temsilci becerileri hakkında bilgi edinin
- Google Ads API MCP sunucusu hakkında bilgi edinin.