Google Ads komut dosyalarındaki gelişmiş API'ler, deneyimli geliştiricilerin belirli herkese açık Google API'lerine HTTP arayüzlerini kullanmaktan daha az kurulumla bağlanmasına olanak tanır. Bu API'leri, komut dosyalarının yerleşik hizmetleri gibi kullanırsınız ve otomatik tamamlama ile otomatik yetkilendirme gibi aynı kolaylıkları sunarlar.
Gelişmiş API'lerin olası kullanım alanları
- Google Analytics 4
- Web sitenize gelen trafiği izlemek ve kampanya tekliflerinizi buna göre ayarlamak için Google Analytics 4'ü kullanabilirsiniz. Google Ads hesabınıza bir Google Analytics 4 mülkü bağlarsanız web sitenizdeki müşteri etkinliğini de analiz edebilirsiniz. Bu bilgilere bakarak Google Ads'in size ne kadar iş veya web sitesi trafiği getirdiğini anlayabilirsiniz. Böylece bu bilgiler, reklamlarınızı ve web sitenizi iyileştirmenizi sağlayabilir. Analytics ve Google Ads hesaplarını bağlama hakkında daha fazla bilgiyi Google Analytics 4 üzerinden edinebilirsiniz.
- Google BigQuery
- Google Cloud Storage'a büyük miktarda veri yükleyebilir ve ardından Google BigQuery'yi kullanarak bu verileri sorgulayabilirsiniz. Örneğin, son 10 yıla ait herkese açık hava durumu verilerini yükleyebilir ve ardından teklifleri ayarlarken bu bilgileri kullanan bir komut dosyasında bir bölgenin ortalama sıcaklığını sorgulayabilirsiniz. Diğer bir kullanım alanı ise hesabınızın birkaç yıllık performans verileri üzerinde sayısal analiz yapmaktır.
- YouTube ve YouTube Analytics
- Teklif verme kararları almak için videolarınızı, oynatma listelerinizi vb. ile videolarınızın performans verilerini alıp güncelleyebilirsiniz.
- Google Takvim
- Komut dosyanız, gelecekteki görevler için etkinlikler oluşturabilir (ör. kampanyalarınız için bugünden 2 hafta sonra bir performans raporu çalıştırma) veya takviminizde oluşturduğunuz bir girişe göre işlemler gerçekleştirebilir (ör. belirli bir tarihte bir kampanyayı etkinleştirme).
- Alışveriş İçeriği
- Komut dosyanız, Apps Script'te Google Content API for Shopping'i kullanabilir. Bu API, Google Merchant Center kullanıcılarına ürün listelemelerini yükleme ve yönetme, ayrıca Merchant Center hesaplarını yönetme olanağı tanır. Bu, komut dosyalarında ürün listelemelerini kontrol etmek ve belirli ürünleri belirli reklamlarla bağlamak için yararlı olabilir.
- Google Görevler
- Komut dosyanız, gelecekteki görevler için bir hatırlatma listesi oluşturabilir (örneğin, kampanyalarınız için bugünden iki hafta sonra bir performans raporu çalıştırma) veya hatırlatma listenizde oluşturduğunuz bir girişe göre işlemler gerçekleştirebilir (örneğin, belirli bir tarihte bir kampanyayı etkinleştirme).
- Google Slaytlar
- Komut dosyanız, kampanya ayrıntılarını veya istatistiklerini Google Slaytlar'a aktararak bu bilgileri sunulabilir bir biçimde yayınlayabilir.
Gelişmiş API'leri etkinleştirme
Hangi Google API'lerinin gelişmiş API olarak kullanılabildiğini görmek için üstteki düzenleyici çubuğunda Gelişmiş API'ler düğmesini tıklayın.
Gelişmiş API'ler iletişim kutusu açılır. Etkinleştirmek istediğiniz API'leri işaretleyin.
Ardından, komut dosyanızla ilişkili projeyi içeren API Konsolu sayfasını Konsol'da açmak için Google API Konsolu bağlantısını tıklayın. Projeniz henüz seçilmemişse Proje açılır listesinden seçin. Arama çubuğuna API adını girerek komut dosyanızda kullanmak istediğiniz API'leri arayın.
Arama sonuçlarında API'yi seçin ve sonraki sayfada Etkinleştir'i seçin. Devre dışı bırak düğmesini görüyorsanız bu API zaten etkindir. Etkinleştirmek istediğiniz her API için bu işlemi tekrarlayın.
Proje için etkinleştirilen API'lerin listesini görüntülemek üzere Kontrol Paneli sayfasını seçin. Komut dosyası için kullanmak istediğiniz tüm Gelişmiş API'lerin listelendiğini doğrulayın.
Şimdi düzenleyicinize dönmek için Gelişmiş API'ler iletişim kutusunu kapatın. Yeni API'ler, komut dosyanız için etkinleştirilir ve otomatik tamamlama listesinde kullanılabilir.
Kullanılabilir API'ler
Aşağıdaki API'ler kullanılabilir:
| API adı | Belgeler |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Takvim | https://developers.google.com/apps-script/advanced/calendar |
| Google Slaytlar | https://developers.google.com/apps-script/advanced/slides |
| Google Görevler | https://developers.google.com/apps-script/advanced/tasks |
| Alışveriş İçeriği | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
Bu API'lerin nasıl kullanılacağıyla ilgili bazı örnekler için kod snippet'leri sayfamıza da bakabilirsiniz.
Göz önünde bulundurulması gereken son noktalar
Gelişmiş API'lerle çalışırken aklınızda bulundurmanız gereken birkaç nokta vardır.
Proje kimliği
Her Google Ads komut dosyasının ilişkili bir Google Cloud proje kimliği (proje numarası olarak da bilinir) vardır. Komut dosyanızın proje numarasını Gelişmiş API'ler iletişim kutusundan Google API Konsolu sayfasını açarak bulabilirsiniz. Bu proje kimliği, komut dosyası oluşturduğunuzda oluşturulur ve Google Ads komut dosyasını oluşturan kullanıcıya bağlıdır. Komut dosyasını oluşturan kullanıcı daha sonra hesaptan kaldırılırsa komut dosyasına erişmeye çalışan bir kullanıcıdan komut dosyasını yeniden yetkilendirmesi ve Gelişmiş API bağımlılıklarını tekrar ayarlaması istenir. Yeni bir Google Geliştirici Projesi kimliği de oluşturulur ve bu belgenin önceki bölümlerinde açıklandığı gibi Gelişmiş API'leri tekrar ayarlamanız gerekir.
Bağımlılıklar
Hesapta komut dosyasını oluşturan kullanıcı, bu komut dosyasının Gelişmiş API bağımlılıklarını değiştirebilir.
İzinler
API'lere erişirken komut dosyası, komut dosyasını yetkilendiren kullanıcının izinlerini kullanır. Komut dosyasını yetkilendiren kullanıcının, kullanılan tüm Gelişmiş API'lere ve komut dosyasının ihtiyaç duyduğu verilere erişmek için gerekli izinlere sahip olduğundan emin olun. Google Analytics API'sini kullanıyorsanız komut dosyasını yetkilendiren kullanıcının, erişilen Analytics hesabı için gerekli izinlere sahip olduğunu doğrulayın.
Hükümler ve Koşullar
Gelişmiş API'lerin her birinin kendi Hükümler ve Koşulları olabilir. Bu Hükümler ve Koşulları, Google API Konsolu'nda API'yi etkinleştirirken kabul etmeniz gerekir.
Kota
Çoğu Advanced API'nin ücretsiz bir günlük kotası vardır. Komut dosyanız bu kotayı aştığında, ek veri isteğinde bulunana veya ücretsiz kota yenilenene kadar API çalışmayı durdurur. Gelişmiş API'ler iletişim kutusundan komut dosyası için Google API Console'u açarak komut dosyanızın kullandığı kotayı izleyebilirsiniz. Google API Konsolu, API için ek kota isteğinde bulunmanıza da olanak tanır.
Faturalandırma
Bazı gelişmiş API'lerin kullanımı için ödeme yapmanız gerekir. Bu ödemeler, komut dosyanızla ilişkili Google Cloud projesi üzerinden yönetilir ve Google Ads üzerinden yönetilmez. Komut dosyanızın Google Cloud projesi için faturalandırmayı etkinleştirme hakkında daha fazla bilgi edinmek için dokümanlarımıza göz atın.