Search Ads 360 Reporting API, tüm kullanıcılar için optimum sistem performansı sağlamak amacıyla API işlemlerinde sınırlar uygular.
Fiyatlandırma
Search Ads 360 Reporting API'nin kullanımı, Search Ads 360'ın genel fiyatlandırmasına dahildir. API kullanımı için ek ücret alınmaz.
Sorgu Sınırları
Search veya SearchStream yöntemleriyle gerçekleştirilen sorgu işlemleri için aşağıdaki sınırlar uygulanır.
- Kullanıcı başına bir projede dakikada 3.000 sorgu
- Proje başına dakikada 3.000 sorgu
- Proje başına günlük 150.000 sorgu
Günlük API işlem sınırları
Günlük API kullanım sınırları, Google Cloud projesi başına yapılan API işlemlerinin sayısına bağlıdır.
Sonuçların SearchAds360Service.SearchStream üzerinden akışına veya SearchAds360Service.Search çağrısından sayfa alınmasına bakılmaksızın, tek bir sorgu veya rapor bir işlem olarak sayılır.
Daha fazla bilgi edinin.
Aşağıdaki tabloda, hesaplamaya ilişkin bazı örnekler verilmiştir:
| API isteği | Günlük Sınır içinde sayılan işlemler |
|---|---|
İşlem: Search
Sayı: 53 reklam grubu
Hizmet: |
1 |
İşlem: SearchStream
Sayı: 45 kampanya
Hizmet: |
1 |
Bu sınırları ihlal eden istekler şu hatayla birlikte reddedilir:
RESOURCE_EXHAUSTED.
Arama istekleri
Search veya SearchStream isteği, kullanıcının günlük işlem kotasında tek bir işlem olarak sayılır. Bir SearchStream isteği, grup sayısından bağımsız olarak bir API işlemi olarak sayılır.
gRPC sınırlamaları
Tüm Search Ads 360 Reporting API istemci kitaplıkları, istek ve yanıt oluşturmak için gRPC'yi kullanır. Varsayılan olarak gRPC'nin mesaj boyutu 4 MB'tır.
Yanıt sayısı bu sınırı aşmamalıdır. Örneğin, çok sayıda alan içeren bir arama isteği, 4 MB'ı aşan bir yanıt oluşturabilir. Bu sınırı önlemek için seçilen alanların sayısını azaltabilir, sayfa boyutunu küçültebilir veya akış özelliğini kullanabilirsiniz.
Bu sınırlamayı ihlal eden istekler SearchAds360Error oluşturmaz ancak 429 Resource Exhausted gRPC hatası oluşturur. gRPC hata kodları ve mesajları listesine bakın.
Sayfalara ayrılmış istekler
Sayfalara ayrılmış istekler (örneğin, geçerli bir next_page_token içeren istekler) kullanıcının günlük işlem kotasına dahil edilmez.
Ancak süresi dolmuş veya geçersiz sayfa jetonu içeren sayfalara ayırma istekleri bir istisna oluşturur ve günlük işlem kotasına dahil edilir.
Arama istekleri gibi sayfalara ayrılan istekler de Page size cannot exceed 10,000 rows sınırlamasına tabidir ve bu sınırı ihlal etmesi halinde şu hatayla birlikte reddedilir:
INVALID_PAGE_SIZE.
Sayfalara ayırma hakkında daha fazla ayrıntı için Sonuçları sayfalandırma bölümüne bakın.
API istisnaları döndüren istekler
SearchAds360Failure ile reddedilen istekler yine kullanıcının günlük işlem kotasına dahil edilir.
Başarısız olan ancak SearchAds360Failure döndürmeyen istekler (örneğin, ağ düzeyindeki bir hatadan dolayı) hizmete hiçbir zaman ulaşamayacağı için kullanıcının günlük işlem kotasına dahil edilmez. Buna örnek olarak ağ bağlantısı
hatası verilebilir.
Diğer sınır türleri
İstekte çok fazla öğeye sahip olan işlemler listesi gibi tekrarlanan bir alan, şu hatayla sonuçlanabilir:
REQUEST_SIZE_LIMIT_EXCEEDED.
Aynı hata mesajı başka sorunlardan da kaynaklanıyor olabilir.
Bir Search Ads 360 Sorgu Dili sorgusu oluştururken IN yan tümcesindeki maksimum öğe sayısı 20.000'dir. Bu sınırı aşarsanız FILTER_HAS_TOO_MANY_VALUES hatası döndürülür.