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. Bu API'ler, otomatik tamamlama ve otomatik yetkilendirme gibi aynı kolaylıkları sunar.
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
- Not: Gelişmiş API'ler iletişim kutusundaki
Analyticsgelişmiş API'si, kullanımdan kaldırılan Universal Analytics v3 API'yi hedeflediğinden bu API'ye gönderilen istekler başarısız olur. Google Ads komut dosyaları, Google Analytics 4AnalyticsDataveyaAnalyticsAdmingelişmiş hizmetlerini desteklemez. Bir komut dosyasından Google Analytics 4 verilerini sorgulamak içinUrlFetchApphizmetini ve OAuth 2.0'ı kullanarak Google Analytics Data API'ye HTTPS istekleri gönderin. Web sitesi ve uygulama dönüşüm verilerini doğrudan paylaşmak için Google Ads hesabınıza bir Google Analytics 4 mülkü de bağlayabilirsiniz. Kurulum talimatları için Analytics kurulum kılavuzuna bakın. - 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 ardından, teklifleri ayarlarken bu bilgileri kullanan bir komut dosyasında bir bölgenin ortalama sıcaklığını sorgulayabilirsiniz. Başka bir kullanım alanı da 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 etkinlikler oluşturabilir (ör. bugünden itibaren 2 hafta boyunca kampanyalarınız için performans raporu çalıştırma) veya takviminizde oluşturduğunuz bir girişe göre işlemler gerçekleştirebilir (ör. belirli bir tarihte kampanya 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ırlatıcı listesi oluşturabilir (ör. bugünden iki hafta sonra kampanyalarınız için bir performans raporu çalıştırma) 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ştirme).
- Merchant API
- Komut dosyanız, ürün listelemelerinizi yükleyip yönetmek ve Google Merchant Center hesaplarınızı yönetmek için Merchant API'yi kullanabilir. Komut dosyalarında bu, ürün listelemelerini kontrol etmek ve belirli ürünleri belirli reklamlara bağlamak için yararlı olabilir. 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 kılavuzunda bulabilirsiniz.
- Alışveriş İçeriği
- Komut dosyanız, ürün listelemelerinizi yükleyip yönetmek ve Google Merchant Center hesaplarınızı yönetmek için Google Content API for Shopping'i kullanabilir. Komut dosyalarında bu, ü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 kararları almak için videolarınızı, oynatma listelerinizi ve diğer içeriklerinizi, ayrıca 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'i tıklayarak Gelişmiş API'ler iletişim kutusunu görüntüleyin. Etkinleştirmek istediğiniz API'leri seçin.
Seçimlerinizi kaydetmek ve komut dosyası düzenleyiciye dönmek için Kaydet'i tıklayın. Yeni API'ler komut dosyanız için etkinleştirilir ve otomatik tamamlama listesinde kullanılabilir.
Göz önünde bulundurulacak diğer noktalar
Gelişmiş API'lerle çalışırken dikkat etmeniz gereken birkaç nokta vardır.
Bağımlılıklar
Yalnızca hesaptaki komut dosyasını oluşturan kullanıcı, ilgili komut dosyasının gelişmiş API bağımlılıklarını değiştirebilir.
İzinler
Gelişmiş API'lere erişirken komut dosyası, komut dosyasına yetki veren kullanıcının izinlerini kullanır. Yetkilendirme yapan kullanıcının, komut dosyasının ihtiyaç duyduğu tüm verilere gerekli erişimi olmalıdır. Örneğin, BigQuery gelişmiş API'sini kullanmak için yetkilendirme yapan kullanıcının hedef Google Cloud projesi ve BigQuery veri kümesi için gerekli izinlere sahip olması gerekir.
Mayıs 2019'dan önceki komut dosyaları için dikkat edilmesi gereken noktalar
Mayıs 2019'dan önce oluşturulan komut dosyaları için, komut dosyasının ilişkili Google Cloud projesinde ilgili API'leri manuel olarak etkinleştirmeniz gerekebilir. Gelişmiş API'ler iletişim kutusunda Google Cloud Console bağlantısı görüyorsanız komut dosyanız etkileniyor demektir.
Gelişmiş API'leri etkinleştirme
2019'dan önceki komut dosyaları için, komut dosyanızda kullanmak istediğiniz her gelişmiş API'yi manuel olarak etkinleştirmeniz gerekir:
- Advanced APIs (Gelişmiş API'ler) düğmesini tıklayın. Aşağıdaki iletişim penceresinde Google Cloud Console bağlantısını tıklayın.
- Projeniz seçili değilse Proje açılır listesinden projenizi seçin.
- Arama çubuğuna API adını girerek komut dosyanızda kullanmak istediğiniz API'leri arayın.
- Arama sonuçlarından API'yi seçin ve sonraki sayfada "Etkinleştir" düğmesini tıklayın.
Komut dosyasını oluşturan kullanıcı daha sonra hesaptan kaldırılırsa komut dosyasına erişmeye çalışan yeni kullanıcılardan gelişmiş API bağımlılıklarını tekrar etkinleştirmeleri ve komut dosyasını yeniden yetkilendirmeleri istenir.