Google Ads komut dosyaları, tarayıcı tabanlı bir IDE'de modern JavaScript (ES6+) kullanarak Google Ads reklam verilerinizi programatik olarak yönetmenize ve sorgulamanıza olanak tanıyan sunucusuz bir otomasyon platformu sağlar. Google Ads komut dosyalarıyla, sunucu sağlamaya veya geliştirici kimlik bilgilerini yönetmeye gerek kalmadan rutin hesap yönetimi iş akışlarını otomatikleştirebilir, özel raporlar oluşturabilir ve Google Ads'i harici veri kaynaklarıyla (tek bir hesapta veya binlerce hesapta) entegre edebilirsiniz.
Google Ads'in çoğu özelliği, mutate ve search çağrıları aracılığıyla Google Ads komut dosyalarında kullanılabilir. Komut dosyalarını kullanarak yapabilecekleriniz:
- Kampanyaları, reklam gruplarını, anahtar kelimeleri ve reklamları yönetme
- Teklifleri, bütçeleri ve durumu gerçek zamanlı performansa veya harici verilere göre ayarlayın.
- Özel raporlar ve kontrol panelleri oluşturmak için Google Ads Sorgu Dili'ni (GAQL) kullanarak sorgular çalıştırın.
- Otomatik yürütmeleri saatlik, günlük, haftalık, aylık veya isteğe bağlı olarak çalışacak şekilde planlayın.
- Yönetici komut dosyalarını kullanarak alt hesaplar genelinde çoklu hesap işlemlerini koordine edin.
- Google Workspace hizmetlerine (ör. E-Tablolar ve Drive), Google Cloud hizmetlerine (ör. BigQuery) ve üçüncü taraf API'lerine bağlanın.
Senaryolar ayrıca yerleşik varlık seçiciler ve raporlar da içerir.
Başlıca teknik özellikler
Aşağıdaki teknik özellikler, Google Ads komut dosyalarının yürütme ortamını ve operasyonel sınırlarını tanımlar:
| Spesifikasyon | Tek hesap komut dosyası | Yönetici hesabı komut dosyası |
|---|---|---|
| Yürütme zaman aşımı | Maksimum 30 dakika |
executeInParallel ile geri arama özelliği kullanıldığında 60 dakikaya kadar
(Standart süre 30 dakikadır.)
|
| Çalışma zamanı motoru | V8 JavaScript çalışma zamanı (ECMAScript 6+) | V8 JavaScript çalışma zamanı (ECMAScript 6+) |
| Öğe yineleyici sınırı | Yineleyici başına varsayılan olarak 50.000 öğe (raporlar ve arama sorguları hariçtir) | Alt hesap başına 50.000 öğe (raporlar ve arama sorguları hariçtir) |
| Paralel hesaplar | Geçersiz (1 hesap) | Aynı anda 50 hesap |
| Toplu yükleme sınırı | 50 MB dosya boyutu, 1.000.000 satır | 50 MB dosya boyutu, 1.000.000 satır |
| Yetkili komut dosyaları | Kullanıcı başına en fazla 250 yetkili komut dosyası | Kullanıcı başına 250'ye kadar yetkilendirilmiş komut dosyası |
| Barındırma ve altyapı | Tümüyle Google tarafından yönetilir (sunucusuz) | Google tarafından tümüyle yönetilir (sunucusuz) |
Daha fazla bilgi için Sınırlar bölümüne bakın.
Google Ads komut dosyaları benim için doğru ürün mü?
Google, Google Ads hesaplarını otomatikleştirmeye yardımcı olan birden fazla ürün sunar. Aşağıdaki tabloda, ihtiyaçlarınıza uygun ürünü seçmenize yardımcı olacak yaygın senaryolar ve öneriler özetlenmektedir:
| Senaryo | Öneri | Başlıca özellikler |
|---|---|---|
| Kendi yazılım ürünümü geliştirmek veya Google Ads API ile entegrasyon yapmak isteyen bir geliştiriciyim. Kod yazma, sunucular ve veritabanları dahil olmak üzere yazılım altyapısını yönetme konusunda kendime güveniyorum. | Google Ads API'yi kullanın. | Tam API kontrolü, daha yüksek işleme hızı, özel barındırma ve OAuth yönetimi. |
| Kod yazma konusunda deneyimli bir geliştiriciyim ancak kendi yazılım altyapımı yönetmeyi tercih etmiyorum. | Google Ads komut dosyalarını kullanın. | Google Ads içinde sunucusuz yürütme, otomatik planlama, tarayıcı tabanlı IDE. |
| Geliştirici değilim ancak Google Ads'i otomatikleştirmek için programlama öğrenmeye zaman ayırabilirim. | Google Ads komut dosyalarını kullanma | Basit JavaScript söz dizimi, önceden oluşturulmuş komut dosyası şablonları, IDE otomatik tamamlama ve söz dizimi vurgulama. |
| Video kampanyalarını programatik olarak yönetmek istiyorum. | Google Ads komut dosyalarını kullanın. |
AdsApp.videoCampaigns() kullanarak doğrudan video kampanyası yönetimi.
|
| Görevleri, etkin bir kullanıcı oturumu olmadan çalışacak şekilde planlamak istiyorum. | Google Ads komut dosyalarını kullanın. | Saatlik, günlük, haftalık veya aylık otomatik planlamayla OAuth2 arka plan yetkilendirmesi. |
| İç içe yerleştirilmiş Google Ads hesaplarıma programatik olarak erişmek istiyorum. | Tek bir komut dosyasından yayın alt hesaplarına erişmek için yönetici komut dosyalarını kullanın. |
Alt hesaplar arasında sıralı yineleme veya executeInParallel kullanılarak en fazla 50 alt hesapta paralel yürütme.
|
| Google'a ait veya üçüncü taraf API'lerini Google Ads yönetimine entegre etmek istiyorum. | Google Ads komut dosyalarıyla Google API'lerini veya üçüncü taraf API'lerini kullanma |
Yerleşik Google Workspace hizmetleri (E-Tablolar, Drive, Mail), Gelişmiş Google API'leri (BigQuery, Analytics, YouTube) ve harici REST API'leri için UrlFetchApp.
|
| Daha ayrıntılı analiz için Google Ads raporlarını indirmek isteyen bir veri analistiyim (veya benzer bir rolde çalışıyorum). | Google Ads için BigQuery Veri Aktarım Hizmeti'ni kullanın. | Google Ads reklam verilerini kod kullanmadan BigQuery'ye aktarmak için planlanmış otomatik ardışık düzen. |
| Google Ads'i toplu olarak yönetmek istiyorum ve kod yazmak benim için sorun değil. | Google Ads komut dosyalarıyla toplu yüklemeleri kullanın. | 1.000.000 satıra kadar destekleyen programatik CSV veya e-tablo yükleme. |
| Google Ads'i toplu olarak yönetmek istiyorum ancak kod yazmak istemiyorum. | Otomatik kuralları, toplu yüklemeleri veya Google Ads Editor'ı kullanın. | Toplu güncellemeler ve planlanmış kurallar için kodsuz masaüstü veya kullanıcı arayüzü araçları. |
Ön koşullar
Yalnızca giriş seviyesinde JavaScript bilgisi yeterlidir. IDE; söz dizimi vurgulama, otomatik tamamlama ve önizleme konusunda yardımcı olur. İlk komut dosyanızı yazmaya başlamak için tek ihtiyacınız olan bir Google Ads hesabı.
Sık sorulan sorular
Google Ads komut dosyası mimarisi, yürütme sınırları ve entegrasyonları ile ilgili sık sorulan soruların yanıtlarını öğrenin.
Google Ads komut dosyaları nedir?
Google Ads komut dosyaları, Google Ads'de sunucusuz bir otomasyon ortamı sağlar. Bu API'ler, reklamverenlerin ve geliştiricilerin sunucuları yapılandırmadan, OAuth jetonlarını yönetmeden veya altyapı için ödeme yapmadan performans metriklerini sorgulamak, kampanyalar oluşturup değiştirmek, teklifleri ve bütçeleri güncellemek ve harici API'lerle bağlantı kurmak için JavaScript kodu yazmasına olanak tanır.
Google Ads komut dosyaları ile Google Ads API arasındaki farklar nelerdir?
Google Ads komut dosyaları, JavaScript kullanılarak doğrudan Google Ads hesabınızda çalışır, sunucu altyapısı gerektirmez ve yetkilendirmeyi tarayıcıda otomatik olarak gerçekleştirir. Google Ads API, daha büyük ölçekli kurumsal uygulamalar, üçüncü taraf araçları ve kendi sunucularınızda çalışan, yüksek hacimli veri işlem hatları için tasarlanmış bir REST ve gRPC API'sidir. Bu API, özel geliştirici jetonları ve OAuth kimlik bilgileri gerektirir.
Google Ads komut dosyalarını çalıştırmak için bir sunucuya ihtiyacım var mı?
Hayır. Google Ads komut dosyaları, ek ücret ödemeden tamamen Google'ın bulut altyapısında çalışır. Komut dosyaları oluşturabilir, bunları önizleme modu ile test edebilir ve doğrudan Google Ads web arayüzünde planlayabilirsiniz.
Google Ads komut dosyaları için yürütme sınırları nelerdir?
Bireysel hesaplardaki standart komut dosyaları, her yürütme için en fazla 30 dakika çalışabilir. executeInParallel kullanan yönetici hesabı komut dosyaları, 50 alt hesapta 60 dakikaya kadar yürütülebilir (geri çağırma işlevi belirtildiğinde). Bir komut dosyası zaman aşımına uğrarsa Google Ads, iptal işleminden önce yapılan değişiklikleri yine de uygular. Zaman aşımları, kotalar ve toplu yükleme sınırlarıyla ilgili tüm ayrıntılar için Sınırlar bölümüne bakın.
Google Ads komut dosyaları harici API'lere bağlanabilir mi?
Evet. Google Ads komut dosyaları, Google E-Tabloları okuma ve yazma için SpreadsheetApp, harici REST API'lerine HTTP istekleri gönderme için UrlFetchApp ve BigQuery ile YouTube gibi hizmetlerle entegrasyon için Gelişmiş Google API'leri gibi yerleşik hizmetler içerir. Daha fazla bilgi için Üçüncü taraf API'leri ve Gelişmiş Google API'leri başlıklı makaleleri inceleyin.
Geri bildirim
Google Ads komut dosyalarıyla ilgili geri bildirimlerinizi bizimle paylaşabilirsiniz. Discord'da bize ulaşın.
Desteğe ihtiyacınız varsa komut dosyaları teknik destek ekibiyle iletişime geçin.