Search Ads 360 Reporting API, tüm kullanıcılar için optimum sistem performansı sağlamak amacıyla API işlemleriyle ilgili sınırlamalar uygular.
Fiyatlandırma
Search Ads 360 Reporting API'nin kullanımı, Search Ads 360'ın genel fiyatlandırmasına dahildir. API'nin kullanımı için ek bir ücret alınmaz.
Sorgu Sınırları
Aşağıdaki sınırlar, Search veya SearchStream yöntemleri aracılığıyla gerçekleştirilen sorgu işlemleri için geçerlidir.
- Proje başına kullanıcı başına 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.
SearchAds360Service.SearchStream üzerinden yayınlanan veya bir SearchAds360Service.Search çağrısından sayfalanan sonuçların ne olduğu fark etmeksizin, tek bir sorgu veya rapor bir işlem olarak sayılır.
Daha fazla bilgi edinin.
Aşağıdaki tabloda muhasebeyle 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: |
1 |
İşlem: SearchStream
Sayı: 45 kampanya
Hizmet: |
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 göre 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 kullanır. gRPC'nin varsayılan mesaj boyutu 4 MB'tır.
Yanıtlar bu sınırı aşmamalı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çili alanların sayısını azaltabilir, sayfa boyutunu küçültebilir veya akış kullanabilirsiniz.
Bu sınırı ihlal eden istekler SearchAds360Error oluşturmaz ancak 429 Resource Exhausted gRPC hatası oluşturur. gRPC hata kodları ve mesajları listesine bakın.
Sayfaya bölünmüş istekler
Sayfaya 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 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. Bu sınırı ihlal etmesi durumunda, INVALID_PAGE_SIZE hatasıyla reddedilirler.
Sayfalara ayırma hakkında daha fazla bilgi için Sonuçlara göz atma bölümüne bakın.
API istisnaları döndüren istekler
SearchAds360Failure ile reddedilen istekler, kullanıcının günlük işlem kotasından düşülür.
Ağ düzeyinde bir hata nedeniyle başarısız olan ancak SearchAds360Failure döndürmeyen istekler, hizmete hiçbir zaman ulaşamayacağı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
İşlemler listesi gibi tekrarlanan bir alanda, bir istekte çok fazla öğe bulunursa şu hata oluşabilir:
REQUEST_SIZE_LIMIT_EXCEEDED.
Aynı hata mesajı, başka sorunlardan da kaynaklanıyor olabilir.
Search Ads 360 Sorgu Dili sorgusu oluştururken bir IN yan tümcesinde en fazla 20.000 öğe bulunabilir. Bu sınırı aşarsanız FILTER_HAS_TOO_MANY_VALUES hatası döndürülür.