Google Ads API aracısı becerileri

Google Ads API aracı becerileri, Google Ads API'ye özgü bilgi, talimat ve iş akışlarından oluşan taşınabilir ve bağımsız modüllerdir. Google Ads API temsilci becerileri, Google Antigravity ve Claude Code dahil olmak üzere açık Temsilci Becerileri standardını destekleyen yapay zeka asistanlarıyla çalışır.

Bu aracı becerileri, yapay zeka asistanlarının Google Ads API'nin en iyi uygulamalarını anlamasına, araçları yapılandırmasına ve iş akışlarını daha yüksek doğrulukla ve daha düşük jeton maliyetiyle yürütmesine yardımcı olmak için tasarlanmıştır. Kullanılabilir becerilerin listesi için Kullanılabilir beceriler başlıklı makaleye bakın.

Başlayın

Geliştirme ortamınıza uygun aracı becerilerini yükleyin.

Google Ads API aracı becerilerini yükleme

Çoğu durumda, Google Ads API aracı becerileri tercih ettiğiniz düzenleyiciye tek bir komutla yüklenebilir:

Antigravity

Google Ads API aracı becerileri, Antigravity için Build with Google entegrasyon paketlerinden biri olarak sunulur. Bu paketi iki noktada genel düzeyde erişim için etkinleştirebilirsiniz:

  • İlk katılım sırasında: Google Ads API yığını onay kutusunu işaretleyin.
  • Ayarlar'da:
    1. Ayarlar > Özelleştirmeler'e gidin.
    2. Google Eklentileriyle Oluşturun bölümünde Özelleştir'i, ardından Google Ads API entegrasyonu için İndir'i tıklayın.

Proje düzeyinde erişimi tercih ediyorsanız projenizin dizininde aşağıdaki komutu çalıştırın:

npx skills add google/skills --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

İmleç

Google Ads API aracı becerilerini, becerinin GitHub deposu uç noktasını (ör. https://github.com/google/skills) doğrudan ekleyerek yükleyebilirsiniz. Bunu, düzenleyicinizin ayarlarındaki özel kurallar bölümünde yapabilirsiniz. Daha fazla bilgi için Cursor kuralları belgelerine bakın.

Diğer temsilciler

Açık Agent Skills standardını destekleyen diğer yapay zeka asistanları için npx kullanarak becerileri yükleyebilirsiniz (Node.js gerektirir):

npx skills add google/skills

Google Ads API aracı becerilerini güncelleme

update komutunu çalıştırarak mevcut tüm güncellemeleri alabilir ve eski becerileri temizleyebilirsiniz:

Antigravity

Build with Google aracılığıyla etkinleştirilen entegrasyonlar, düzenleyici tarafından otomatik olarak yönetilir ve güncellenir.

Aracı becerilerini npx komutunu kullanarak yüklediyseniz update komutunu çalıştırarak mevcut tüm güncellemeleri alabilirsiniz:

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

İmleç 

npx skills update --all

Diğer temsilciler

Açık Agent Skills standardını destekleyen diğer yapay zeka asistanları için npx kullanarak etkin becerilerin tümünü güncelleyebilirsiniz:

npx skills update --all

Google Ads API aracısı becerilerini kullanma

Yapay zeka asistanları, bir becerinin açıklamasının mevcut isteğinizle eşleştiğini algıladıklarında becerileri otomatik olarak kullanacak şekilde tasarlanmıştır. Genel olarak yüklenen beceriler, istem bağlamınız Google Ads API görevleriyle eşleşmediği sürece alakasız projelerde etkinleştirilmez.

Beceriler, ajan sohbetine / yazılıp beceri adı aranarak da manuel olarak çağrılabilir.

Becerinin temel bileşenleri

Her bir ajan becerisi, yapay zeka asistanına aşağıdaki bileşenleri sağlayan özel bir pakettir:

  • Özel talimatlar: Asistana GAQL sorguları oluşturma, OAuth kimlik bilgilerini yapılandırma ve yaygın hata kodlarını işleme konusunda rehberlik etmek için bağlam penceresine yerleştirilen ayrıntılı istem talimatları.
  • En iyi uygulamalar: Google Ads API DevRel Ekibi tarafından tanımlanan standart performans, güvenlik ve entegrasyon önerileri.
  • Otomasyon komut dosyaları: Görevleri yerel olarak yürütmek için beceri paketlerine dahil edilen, yürütülebilir komut dosyaları (ör. ortam doğrulama veya çalışma alanı kurulumu için).

Becerileri kullanmanın avantajları

Ajan becerileri, her sohbete hacimli talimatlar yüklemenin getirdiği ek yük olmadan, talep üzerine uzmanlık bilgisiyle asistanın yeteneklerini genişletir.

Daha düşük jeton maliyetleri

Geleneksel yapay zeka entegrasyonları genellikle önceden büyük miktarda doküman yükler. Bu durum, önemli sayıda jeton tüketir ve oturum maliyetlerini artırır. Ajan becerileri, bu ek yükü en aza indirmek için kademeli açıklama kullanır:

  • Yapay zeka asistanı, isteğinizle alakalı olup olmadığını görmek için başlangıçta yalnızca becerinin adını ve açıklamasını kontrol eder.
  • Beceriyle ilgili tüm talimatlar ve referanslar, yalnızca asistanın belirli göreviniz için gerekli olduğuna karar verdiği durumlarda etkin bağlam penceresine eklenir. Bu sayede bağlam alanı tasarrufu sağlanır.

Yapay zeka destekli uygulama

Dokümanlarda manuel olarak arama yapmak yerine amacınızı doğal dilde açıklayabilirsiniz. Beceri, yapay zeka asistanınızın aşağıdaki gibi görevleri gerçekleştirmesini sağlar:

  • Hesabımdan kampanya performansı metriklerini almak için GAQL sorgusu oluşturun.
  • Yeni bir kampanya oluşturmak için istemci kitaplıklarını kullanarak bir Python komut dosyası yazın.
  • Google Ads API'yi kullanarak kampanya dönüşümlerini ve teşhis verilerini alma.

Kullanılabilen becerilerin tam listesi için Kullanılabilen beceriler başlıklı makaleyi inceleyin.

Google Ads API MCP sunucusuyla birlikte becerileri kullanma

Aracı becerileri, Google Ads API Model Bağlam Protokolü (MCP) sunucusunu tamamlayacak şekilde tasarlanmıştır:

  • Google Ads API MCP sunucusu: Yapay zeka destekli geliştirme iş akışları için tasarlanmıştır. Yapay zeka asistanlarının Google Ads API kaynaklarınız, kampanyalarınız ve metriklerinizle programatik olarak etkileşim kurmasına olanak tanır.
  • Google Ads API aracı becerileri: Bir asistana, görevleri jeton açısından verimli ve aşamalı olarak açıklayarak gerçekleştirmesi için yol gösteren istem talimatları ve önerilen uygulamalar sağlar. Bu talimatlar, ajana MCP sunucusu ve istemci kitaplıkları gibi araçların nasıl etkili bir şekilde kullanılacağı konusunda yol gösterir.

Kullanılabilir beceriler

Google Ads API ekibi, Google Ads API ile geliştirme yapmaya yönelik bir dizi beceri sunar:

Beceri Açıklama
google-ads-api-mcp-setup Google Ads API Model Bağlam Protokolü (MCP) sunucusunun kurulup yapılandırılmasına yardımcı olarak yerel ortamlarda kimlik doğrulama ve yapılandırmayı basitleştirir.
google-ads-api-quickstart Geliştirme ortamınızı ayarlama, kimlik bilgilerini yapılandırma ve Google Ads API'ye ilk API çağrınızı yapma konusunda size rehberlik eder.

Sonraki adımlar