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'yi kullanmak için ek ü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.
Sonuçların SearchAds360Service.SearchStream üzerinden akış şeklinde sunulup sunulmadığına veya SearchAds360Service.Search çağrısından sayfa sayfa sunulup sunulmadığı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 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ı
Search Ads 360 Reporting API istemci kitaplıklarının tümü 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ının listesine bakın.
Sayfaya bölünmüş 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 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ı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 sayfalama 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ı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
Bir istekteki çok fazla öğe içeren yinelenen bir alan (ör. işlem listesi) REQUEST_SIZE_LIMIT_EXCEEDED hatasına neden olabilir.
Aynı hata mesajı, başka sorunlardan da kaynaklanabilir.
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.