Google Ads komut dosyalarındaki gelişmiş API'ler, deneyimli geliştiricilerin HTTP arayüzlerini kullanmaktan daha az kurulumla belirli herkese açık Google API'lerine bağlanmasına olanak tanır. Bu API'leri, komut dosyalarının yerleşik hizmetlerine benzer şekilde kullanırsınız. Otomatik tamamlama ve otomatik yetkilendirme gibi aynı kolaylıkları sunarlar.
Gelişmiş API'lerin olası kullanım alanları
- Google Analytics
- Web sitenize gelen trafiği izlemek ve kampanya tekliflerinizi buna göre ayarlamak için Google Analytics'i kullanabilirsiniz. Google Ads hesabınıza bir Google Analytics mülkünü bağlarsanız web sitenizdeki müşteri etkinliğini de analiz edebilirsiniz. Bu bilgiler, web sitesi trafiğinizin veya satışlarınızın ne kadarının Google Ads'den geldiğine açıklık getirebileceği gibi, reklamlarınızı ve web sitenizi iyileştirmenize de yardımcı olabilir. Analytics ve Google Ads hesaplarını bağlama hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz.
- Google BigQuery
- Google Cloud Storage'a büyük miktarda veri yükleyebilir ve ardından Google BigQuery'yi kullanarak bu verilere sorgu gönderebilirsiniz. Örneğin, son 10 yılın herkese açık hava durumu verilerini yükleyebilir ve ardından teklifleri ayarlamak için bu bilgileri kullanan bir komut dosyasında bir bölgenin ortalama sıcaklığını sorgulayabilirsiniz. Diğer bir kullanım alanı da, hesabınızın birkaç yıl boyuncaki performans verilerini analiz etmektir.
- YouTube ve YouTube Analytics
- Teklif verme kararları almak için videolarınızı, oynatma listelerinizi ve videolarınızın performans verilerini alıp güncelleyebilirsiniz.
- Google Takvim
- Komut dosyanız gelecekteki görevler için etkinlikler oluşturabilir (örneğin, bugünden 2 hafta sonra kampanyalarınız için bir performans raporu yayınlayabilir) veya takviminizde oluşturduğunuz bir girişe göre işlemler gerçekleştirebilir (örneğin, belirli bir tarihte bir kampanyayı etkinleştirebilir).
- Alışveriş İçeriği
- Skriptiniz, Apps Script'te Alışveriş için Google Content API'yi kullanabilir. Bu API, Google Merchant Center kullanıcılarına ürün listelemelerini yükleyip yönetme ve Merchant Center hesaplarını yönetme olanağı sunar. Komut dosyalarında bu, ürün listelemelerini kontrol etmek ve belirli ürünleri belirli reklamlara bağlamak için yararlı olabilir.
- Google Görevler
- Komut dosyanız gelecekteki görevler için bir hatırlatıcı listesi oluşturabilir (ör. bugünden iki hafta sonra kampanyalarınız için bir performans raporu çalıştırabilir) veya hatırlatıcı listenizde oluşturduğunuz bir girişe göre işlemler gerçekleştirebilir (ör. belirli bir tarihte bir kampanyayı etkinleştirebilir).
- Google Slaytlar
- Komut dosyanız, kampanya ayrıntılarını veya istatistiklerini Google Slaytlar'a aktararak bu tür bilgileri sunulacak bir biçimde yayınlayabilir.
Gelişmiş API'leri etkinleştirme
Gelişmiş API olarak kullanılabilen Google API'lerini görmek için üstteki düzenleyici çubuğunda Gelişmiş API'ler düğmesini tıklayın.
Bu işlem, Gelişmiş API'ler iletişim kutusunu açar. Etkinleştirmek istediğiniz API'leri işaretleyin.
Ardından, Google API Konsolu bağlantısını tıklayarak Console'da komut dosyanızla ilişkili projenin bulunduğu API Konsolu sayfasını açın veya projeniz seçili değilse 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 tıklayın. Devre dışı bırak düğmesi görüyorsanız bu API zaten etkindir. Etkinleştirmek istediğiniz her API için bu işlemi tekrarlayın.
Proje için etkin 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.
Ardından, 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ğına dair bazı örnekler için kod snippet'leri sayfamıza da bakabilirsiniz.
Son noktalar
Gelişmiş API'lerle çalışırken göz önünde bulundurmanız gereken birkaç nokta vardır.
Proje kimliği
Her Google Ads komut dosyasının, Google Cloud Platform proje kimliği (proje numarası olarak da bilinir) vardır. Komut dosyanızın proje numarasını Gelişmiş API'ler iletişim kutusunda Google API Konsolu sayfasını açarak bulabilirsiniz. Bu proje kimliği, komut dosyasını oluşturduğunuzda oluşturulur ve Google Ads komut dosyasını oluşturan kullanıcıya bağlanır. Komut dosyasını oluşturan kullanıcı daha sonra hesaptan kaldırılırsa komut dosyasına erişmeye çalışan kullanıcıdan komut dosyasını yeniden yetkilendirmesi ve Gelişmiş API bağımlılıkları ayarlarını tekrar yapması istenir. Yeni bir Google geliştirici proje 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
Yalnızca hesapta komut dosyasını oluşturan kullanıcı, ilgili komut dosyasının Gelişmiş API bağımlılıkları değiştirebilir.
İzinler
Bir komut dosyası, API'lere erişirken komut dosyasını yetkilendiren kullanıcının izinlerini kullanır. Komut dosyasına yetki veren kullanıcının, kullanılan tüm Gelişmiş API'lere ve komut dosyasının ihtiyaç duyduğu verilere gerekli erişime sahip olduğundan emin olun. Google Analytics API'yi kullanıyorsanız komut dosyasına yetki veren kullanıcının, erişilen Analytics hesabı için gerekli izinlere sahip olduğundan emin olun.
Hükümler ve Koşullar
Gelişmiş API'lerin her birinin, Google API Konsolu'nda API'yi etkinleştirirken kabul etmeniz gereken kendi Hükümler ve Koşulları olabilir.
Kota
Çoğu gelişmiş API'nin ilişkili bir ücretsiz 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 kutusunda komut dosyasının Google API Console'unu açarak komut dosyanız tarafından kullanılan kotayı izleyebilirsiniz. Google API Konsolu, API için ek kota isteğinde bulunmanızı da sağlar.
Faturalandırma
Bazı gelişmiş API'ler için kullanım ücreti ödemeniz gerekir. Bu ödemeler Google Ads üzerinden değil, komut dosyanızla ilişkili Google Cloud Platform projesi üzerinden yönetilir. Komut dosyanızın Google Cloud Platform projesi için faturalandırmayı etkinleştirme hakkında daha fazla bilgi için dokümanlarımıza göz atın.