Google Ads komut dosyalarındaki gelişmiş API'ler, 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 kullanabilirsiniz. Ayrıca, otomatik tamamlama ve otomatik yetkilendirme gibi aynı kolaylıkları sunarlar.
Bu API'lerin nasıl kullanılacağını gösteren bazı örnekler için kod snippet'leri sayfamıza bakın.
Kullanılabilir Gelişmiş API'ler
- 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ü 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 Web siteleri ve/veya uygulamalar için Analytics'i ayarlama başlıklı Yardım Merkezi kılavuzunda bulabilirsiniz.
- 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.
- Google Takvim
- Komut dosyanız, gelecekteki görevler için etkinlik oluşturabilir (örneğin, 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 (ö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.
- 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).
- Merchant API
- Komut dosyanız, ürün listelemelerinizi yüklemek ve yönetmek, Google Merchant Center hesaplarınızı yönetmek için Merchant API'yi kullanabilir. Bu özellik, komut dosyalarında ürün listelemelerini kontrol etmek ve belirli ürünleri belirli reklamlara bağlamak için kullanılabilir. Merchant API'nin, Gelişmiş API'ler iletişim kutusunda ayrı ayrı etkinleştirilebilen alt API'leri vardır. Google Merchant Center hesabınızı bağlama hakkında daha fazla bilgiyi Geliştirici olarak kaydolma rehberinde bulabilirsiniz.
- Alışveriş İçeriği
- Komut dosyanız, ürün listelemelerinizi yüklemek ve yönetmek ile Google Merchant Center hesaplarınızı yönetmek için Google Content API for Shopping'i kullanabilir. Bu işlev, komut dosyalarında ürün listelemelerini kontrol etmek ve belirli ürünleri belirli reklamlara bağlamak için yararlı olabilir. Not: Content API for Shopping, 18 Ağustos 2026'da kullanımdan kaldırılacak. Bunun yerine önceki bölümde açıklanan Merchant API'yi kullanın.
- YouTube ve YouTube Analytics
- Teklif verme kararları vermek için videolarınızı, oynatma listelerinizi vb. ve videolarınızın performans verilerini alıp güncelleyebilirsiniz.
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, Google API Konsolu bağlantısını tıklayarak Konsol'da API Konsolu sayfasını açın. Bu sayfada, komut dosyanızla ilişkili proje gösterilir. 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 Advanced 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.
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. Google API Konsolu sayfasını Gelişmiş API'ler iletişim kutusundan açarak komut dosyanızın proje numarasını 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. 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'ler 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. Google API Konsolu'nda API'yi etkinleştirirken bu Hükümler ve Koşulları 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ı ücretlidir. 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 belgelerimizi inceleyin.