Google Ads API Geliştirici Asistanı

Google Ads API Geliştirici Asistanı, Google Ads API iş akışlarınızı hızlandırmak için tasarlanmış Gemini CLI'ye yönelik güçlü bir uzantıdır. Asistan, doğal dili kullanarak Google Ads API ile etkileşim kurmanıza olanak tanır. Böylece, doğrudan terminalinizde soru sormak, kod oluşturmak, veri almak ve sorunları gidermek kolaylaşır.

Avantajları

  • Üretkenliği artırma: Doküman arama ve standart kod yazma işlemlerine daha az zaman harcayın.
  • Karmaşık görevleri basitleştirme: Basit İngilizce istemlerden Google Ads Sorgu Dili (GAQL) ve istemci kitaplığı kodu oluşturun.
  • API'yi öğrenin: API kavramlarını anlayın ve doğal dil isteklerinin nasıl çalıştırılabilir koda dönüştürüldüğünü görün.
  • Etkileşimli hata ayıklama: Hataları anlamanıza ve sorun giderme konusunda adım adım rehberliğe yardımcı olur.
  • Kolaylaştırılmış iş akışı: Geliştirme ve test döngünüzü komut satırında tutun.

Ön koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  1. Google Ads API Erişimi:

  2. Yazılım:

    • Python 3.10 veya sonraki sürümler. Python varsayılan dil olduğundan bu dili yüklemiş ve yolunuza eklemiş olmanız gerekir.
    • Gemini CLI yüklü olmalıdır.
    • jq (komut satırı JSON işlemcisi). Kurulum komut dosyası, eksikse bunu yüklemeye çalışır.

  3. Depo:

    • GitHub'daki google-ads-api-developer-assistant deposunun yerel bir kopyası:

Başlayın

  1. Proje dizinine gidin:

    cd <full path>/google-ads-api-developer-assistant

  2. Kurulum komut dosyasını çalıştırın: Bu komut dosyası, Gemini CLI'yı asistanın GEMINI.md bağlam dosyalarını ve gerekli araçları kullanacak şekilde yapılandırır.

    ./setup.sh

    Windows kullanıyorsanız setup.ps1 PowerShell komut dosyasını çalıştırın.

  3. Gemini CLI'yı başlatın:

    gemini

  4. Asistan ile etkileşim kurma: Artık doğal dilde sorular sorabilir veya komutlar verebilirsiniz.

Temel özellikler

  • Doğal dilde soru-cevap: Google Ads API özellikleri, en iyi uygulamalar veya belirli kaynaklar hakkında sorular sorun.

    • "Mevcut kampanya türleri nelerdir?"
    • "GAQL'de tarihe göre nasıl filtreleme yaparım?"
    • "click_view ile impression_view arasındaki farkı açıkla."

  • Kod oluşturma: GAQL sorguları ve çalıştırılabilir Python kodu snippet'leri oluşturun.

    • "Son 30 günde en çok dönüşüm elde eden kampanyaları göster."
    • "12345 kimlikli kampanya için etkinleştirilmiş tüm reklam grubu adlarını al."
    • "Tüm kampanyalardaki onaylanmayan reklamları bulun." Oluşturulan kod, saved_code/ dizinine kaydedilir.

  • Doğrudan API yürütme: Oluşturulan salt okunur Python komut dosyalarını doğrudan Gemini CLI'dan çalıştırın ve biçimlendirilmiş sonuçları terminalinizde görüntüleyin. Asistan kodu oluşturduktan sonra ekranda şu istemi görürsünüz:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

run girin. Komut dosyası, Asistan bağlamında yürütülür.

  • CSV dışa aktarma: API çağrılarından elde edilen tablo biçimindeki sonuçları CSV dosyasına kaydedin.

    • "Sonuçları CSV dosyasına kaydedin." Dosyalar saved_csv/ dizinine kaydedilir.

  • Sorun giderme yardımı: Hata mesajları veya beklenmeyen API davranışlarıyla ilgili yardım alın.

    • "Kimlik doğrulama hatası.OAUTH_TOKEN_INVALID hatasını aldım. Ne yapmalıyım?"
    • "Sorgumla ilgili neden sonuç göremiyorum?"

Örnek kullanım alanları

  • Raporlama:
    • "12345678 numaralı müşteri için geçen ay maliyete göre ilk 5 anahtar kelimeyi göster."
  • Hesap yapısı:
    • "Tüm kampanya adlarını ve kimliklerini listele."
  • Sorun giderme:
    • "100 dönüşüm yükledim ancak kullanıcı arayüzünde yalnızca 78 dönüşüm görünüyor. API'yi kullanarak bu sorunu nasıl ayıklayabilirim?"
  • Öğrenme:
    • "API'yi kullanarak Maksimum Performans kampanyası oluşturma konusunda bana yol göster."

Topluluk ve destek

Katkıda bulunma yönergeleri

Katkılarınızı bekliyoruz. Yönergeler için GitHub deposundaki CONTRIBUTING.md dosyasına bakın.