Google Ads API Geliştirici Asistanı'nı yükleme ve kullanma

Ö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). Yükleme komut dosyası, eksikse bunu yüklemeyi dener.

  3. Depo:

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'yi asistanın GEMINI.md bağlam dosyalarını ve gerekli araçları kullanacak şekilde yapılandırır.

    ./install.sh

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

  3. gemini-cli'yi başlatma:

    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 yürütülebilir Python kodu snippet'leri oluşturun.

    • "Son 30 günde en çok dönüşüm elde eden kampanyaları göster."
    • "12345 kampanya kimliği 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'den çalıştırın ve biçimlendirilmiş sonuçları terminalinizde görüntüleyin. Asistan kodu oluşturduktan sonra ekranda bir istem gösterilir:

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. Varsayılan diliniz Python, Ruby veya PHP ise komut dosyası Asistan bağlamında yürütülür. Derlenmiş diller, güvenlik politikaları nedeniyle çalışmaz.

  • CSV dışa aktarma: API çağrılarından elde edilen tablosal 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?"
    • "Neden sorgumla ilgili sonuç görmüyorum?"

Ö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:
    • "/explain what a shared set is" (Paylaşılan kümenin ne olduğunu açıkla)
  • Kod üretme:
    • "company name için Maksimum Performans kampanyası oluşturacak kodu yaz."

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.