Google Ads komut dosyalarındaki gelişmiş API'ler, deneyimli geliştiricilerin, HTTP arayüzlerini kullanmaya kıyasla 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 çok benzer şekilde kullanırsınız. Ayrıca, otomatik tamamlama ve otomatik yetkilendirme gibi aynı kolaylıkları da sunarlar.
Gelişmiş API'ların olası kullanımları
- Google Analytics
- Google Analytics'i kullanarak web sitenize gelen trafiği izleyebilir ve kampanya tekliflerinizi buna göre ayarlayabilirsiniz. Google Ads hesabınıza bir Google Analytics mülkü 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 merkezimizden 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ılın herkese açık hava durumu verilerini yükleyebilir ve daha sonra, teklifleri ayarlarken bu bilgileri kullanan bir komut dosyası yardımıyla bir bölgenin ortalama sıcaklığını sorgulayabilirsiniz. Diğer bir kullanım da, hesabınızın birkaç yıl içindeki performans verilerini analiz etmektir.
- YouTube ve YouTube Analytics
- Teklif kararları vermek için videolarınızın, oynatma listelerinizin vb. yanı sıra 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 itibaren 2 hafta boyunca kampanyalarınız için bir performans raporu çalıştırabilir) veya takviminizde oluşturduğunuz bir girişi temel alarak işlemler gerçekleştirebilir (örneğin, bir kampanyayı belirli bir tarihte etkinleştirme).
- Alışveriş İçeriği
- Komut dosyanız, Apps Komut Dosyası'nda Google Content API for Shopping'i 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 faydalı olabilir.
- Google Görevler
- Komut dosyanız gelecekteki görevler için bir hatırlatıcı listesi oluşturabilir (örneğin, 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şi temel alarak işlemler gerçekleştirebilir (örneğin, bir kampanyayı belirli bir tarihte etkinleştirme).
- Google Slaytlar
- Komut dosyanız, kampanya ayrıntılarını veya istatistiklerini Google Slaytlar'a aktararak bu tür bilgileri sunuma hazırlayabilir.
Gelişmiş API'ları etkinleştir
Hangi Google API'lerinin gelişmiş API olarak kullanılabildiğini görmek için üst düzenleyici çubuğundaki Gelişmiş API'ler düğmesini tıklayın.
Gelişmiş API'ler iletişim kutusu açılır. Etkinleştirmek istediğiniz API'ları işaretleyin.
Ardından, Play Console'da komut dosyanızla ilişkilendirilmiş projenin bulunduğu API Konsolu sayfasını açmak için Google API Konsolu bağlantısını tıklayın. Projeniz henüz 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 bir sonraki sayfada Etkinleştir'i seçin. Devre Dışı Bırak düğmesi görünüyorsa bu API zaten etkinleştirilmiştir. Etkinleştirmek istediğiniz her API için bu işlemi tekrarlayın.
Proje için etkin API'lerin listesini görüntülemek için Kontrol Paneli sayfasını seçin. Komut dosyası için kullanmak istediğiniz tüm Gelişmiş API'ların listelendiğini doğrulayın.
Şimdi düzenleyicinize dönmek için Gelişmiş API'lar 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 (YTA) | 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.
Göz önünde bulundurulması gereken son noktalar
Gelişmiş API'larla çalışırken unutulmaması gereken birkaç nokta vardır.
Proje kimliği
Her Google Ads komut dosyasının, kendisiyle ilişkilendirilmiş bir 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 kutusundan 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ğ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. Ayrıca yeni bir Google Geliştirici Proje Kimliği oluşturulur ve bu belgede daha önce açıklandığı gibi Gelişmiş API'leri yeniden kurmanız gerekir.
Bağımlılıklar
Yalnızca hesapta komut dosyasını oluşturan kullanıcı, söz konusu komut dosyasının Gelişmiş API bağımlılıklarını değiştirebilir.
İzinler
Komut dosyası, API'lere erişirken komut dosyasına yetki veren kullanıcının izinlerini kullanır. Komut dosyasını yetkilendiren kullanıcının, kullanılan tüm Gelişmiş API'ler ve komut dosyasının gerekli olduğu veriler için 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'ların her birinin kendi Şartlar ve Koşulları olabilir. Google API Konsolu'nda API'yi etkinleştirirken bu şartları kabul etmeniz gerekir.
Kota
Çoğu Advanced API'nin kendisiyle ilişkili ücretsiz bir günlük kotası vardır. Komut dosyanız bu kotayı aştığında, siz ek veri isteyene veya ücretsiz kota yenilenene kadar API çalışmayı durdurur. Gelişmiş API'ler iletişim kutusundan komut dosyası için Google API Konsolu'nu 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'ler kullanım için ödeme yapmanızı gerektirir. 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 projesinde faturalandırmayı etkinleştirme hakkında daha fazla bilgi için dokümanlarımızı inceleyin.