Search Ads 360 Reporting API, tüm kullanıcılar için optimum sistem performansı sağlamak amacıyla API işlemlerine sınırlamalar 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ı
Arama veya SearchStream yöntemleri aracılığıyla gerçekleştirilen sorgu işlemleri için aşağıdaki sınırlar geçerlidir.
- Kullanıcı başına her projede bir 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şlemi 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 göre belirlenir.
Sonuçların SearchAds360Service.SearchStream üzerinden yayınlanmasından veya SearchAds360Service.Search çağrısından sayfalara ayrılmasından bağımsız olarak tek bir sorgu ya da rapor tek bir işlem olarak sayılır. Daha fazla bilgi edinin.
Aşağıdaki tabloda muhasebe ile ilgili 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: SearchAds360Service
|
1 |
İşlem: SearchStream
Sayı: 45 kampanya Hizmet: SearchAds360Service
|
1 |
Bu sınırları ihlal eden istekler, RESOURCE_EXHAUSTED hatasıyla reddedilir.
Arama istekleri
Search veya SearchStream isteği, kullanıcının günlük işlem kotasına bir işlem olarak yansıtılır. Toplu işlem sayısından bağımsız olarak bir SearchStream isteği, bir API işlemi olarak sayılır.
gRPC sınırlamaları
Search Ads 360 Reporting API istemci kitaplıklarının tümü, istek ve yanıt oluşturmak için gRPC'yi kullanır. Varsayılan olarak gRPC'nin ileti boyutu 4 MB'tır.
Yanıtlarda bu sınır aşılmamalıdır. Örneğin, çok sayıda alan içeren bir arama isteği, boyutu 4 MB'ı aşan bir yanıt oluşturabilir. Bu sınırı aşmamak için seçilen alanların sayısını azaltabilir, sayfa boyutunu küçültebilir veya akış 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.
Sayfalandırılmış istekler
Sayfalandırı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 bir sayfa jetonu içeren sayfalara ayırma istekleri istisna oluşturur ve günlük işlem kotasına dahil edilir.
Arama istekleri gibi sayfalandırılmış istekler de Page size cannot exceed 10,000 rows sınırlamasına tabidir ve bu sınırı ihlal ederse INVALID_PAGE_SIZE hatasıyla reddedilir.
Sayfalandırma hakkında daha fazla bilgi için Sonuçlar arasında gezinme başlıklı makaleyi inceleyin.
API istisnaları döndüren istekler
SearchAds360Failure ile reddedilen istekler, kullanıcının günlük işlem kotasına dahil edilir.
Başarısız olan ancak SearchAds360Failure döndürmeyen istekler (ör. ağ düzeyindeki bir hatadan kaynaklananlar) hizmete hiçbir zaman ulaşmayacağından 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
İstek içinde çok fazla öğe içeren işlemler listesi gibi yinelenen bir alan şu hataya neden olabilir:
REQUEST_SIZE_LIMIT_EXCEEDED.
Aynı hata mesajı başka sorunlardan da kaynaklanabilir.
Search Ads 360 sorgu dili sorgusu oluştururken bir IN ifadesindeki maksimum öğe sayısı 20.000'dir. Bu limiti aşarsanız FILTER_HAS_TOO_MANY_VALUES hatası döndürülür.