Yeni Google Ads komut dosyaları altyapısı Google Ads API'yi temel alır. Bu API'nin farklı mimarisi nedeniyle mevcut komut dosyalarınızı güncellemeniz gerekebilir. Mümkün olduğunca geriye dönük uyumluluk sağlamak için elimizden geleni yaptığımızdan bu değişiklikler küçük olacaktır.
Raporlar
Birçok AWQL raporu çalışmaya devam edecektir. Yeni altyapıyı kullanırken komut dosyaları, arka planda yeni altyapıyı kullanırken AWQL sorgunuzu GAQL'ye (Google Ads API'nin yeni sorgu dili) dönüştürür, yeni arka uçta çalıştırır ve ardından sonuçları orijinal olarak AWQL raporlarında kullanılan biçime geri dönüştürür. GAQL içeren sorgular olduğu gibi iletilir.
Bu ek yük nedeniyle, komut dosyalarınızı gözden geçirmenizi ve mümkün olduğunda AWQL sorgularını GAQL'ye güncellemenizi öneririz. Belirli bir AWQL sorgusunun GAQL sorgusunu belirlemek için komut dosyalarıyla aynı mantığı kullanan sorgu taşıma aracını kullanabilir veya sorgu oluşturmanıza yardımcı olması için etkileşimli sorgu oluşturucuyu kullanabilirsiniz.
Otomatik AWQL'den GAQL'ye çevirinin bazı sınırlamaları aşağıda verilmiştir:
- Bazı AWQL sorguları GAQL sorgularına düzgün şekilde çevrilemez. Bu gibi durumlarda, manuel olarak düzeltmenize yardımcı olması için ne gibi bir sorun olduğuna dair bazı ayrıntıları içeren bir hata mesajı günlüğe kaydedilir.
- AWQL'deki tüm rapor türleri GAQL'de desteklenmez.
- GAQL'de "sıfır gösterim satırları" için destek yoktur. Bir raporun sıfır gösterim içermesi gerektiğini belirtmek hataya neden olur.
- Anlamları belirsiz olan bazı alanlar filtrelerde kullanılamaz. Örneğin, "Başlık", herhangi bir sayıda farklı reklam alanına referans verebilir.
- Bazı alanlar, sonuçları farklı bir biçimde döndürebilir (ör. bir sonucu birçok sütuna bölme).
Düzenleyici seçiciler
Komut dosyaları kullanılarak kaynaklar getirilirken iteratördeki sonuçları kısıtlamak veya sıralamak için withCondition ve orderBy çağrılarının kullanılması oldukça yaygındır. Bu çağrılardaki alanlarda artık yeni Google Ads API adları kullanılıyor. Örneğin, kampanya adına göre filtrelemek için daha önce şunları kullanırdınız:
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
Artık, mümkün olduğunda bu koşullar için yeni alan adlarını kullanmanız gerekir:
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
Bununla birlikte, eski adların yeni adlarla eşlenmesini sağlamak için gereken tüm çabayı gösterdik. Bu nedenle, komut dosyanızda hâlâ CampaignName kullanılıyorsa komut dosyasının çalışmaya devam etmesini sağlamak için çalışma zamanında otomatik olarak campaign.name ile değiştirilir. Eski stil adlarla ilgili sorun yaşarsanız ilk sorun giderme adımı olarak komut dosyalarınızı yeni stil adları kullanacak şekilde güncelleyin.
Sınırlar
Birçok sınır, eski altyapıdakiyle aynıdır ve burada yapılan değişiklikler genellikle performansı artırmaya yardımcı olur.
- Zaman sınırları aynı. Bir komut dosyası 30 dakika boyunca yürütülebilir.
- Tek bir yineleme varsayılan olarak 50.000 varlık döndürür ancak bu değer geçersiz kılınabilir. Daha önce bu 50.000 sınırı özelleştirilemezdi.
- Tek bir seçici en fazla 10.000 kimliği (değişmez) işleyebilir.
- Yeni altyapıda, tek bir komut dosyasında işlenebilecek öğe sayısıyla ilgili bir sınır yoktur. Daha önce bu sınır 250.000'di.
- Yeni altyapıda yürütme başına oluşturulabilecek anahtar kelime veya reklam sayısıyla ilgili bir sınırlama yoktur. Önceki sınır 250.000'di.
- Günlük çıktısı 100 KB olarak kısaltılmıştır (değiştirilmemiştir).
- Apps Komut Dosyası hizmetleri (SpreadsheetApp, MailApp vb.) için kotalar değişmez.
- Google Ads için kotalar, API'yi kullanıyormuşsunuz gibi uygulanır. Yani komut dosyanız API hız sınırlamalarına tabi olur ancak bu, daha fazla rapora erişmek veya yürütme başına daha fazla değişiklik yapmak için daha fazla esneklik sağlar.
Diğer değişiklikler
Bu kotalar artık yeni deneyimde geçerli olmadığından ExecutionInfo artık getRemainingCreateQuota() veya getRemainingGetQuota()'i göstermez.