Search Ads 360 Reporting API, tüm kullanıcılar için en iyi sistem performansını 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'nin kullanımı için ek bir ücret alınmaz.
Sorgu Sınırları
Aşağıdaki sınırlar, Arama veya SearchStream yöntemleriyle gerçekleştirilen sorgu işlemleri için geçerlidir.
- Her bir projede kullanıcı başına dakikada 3.000 sorgu
- Proje başına dakikada 3.000 sorgu
- Proje başına günde 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 bağlıdır.
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, muhasebeye 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ına 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. Varsayılan olarak gRPC'nin 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ırdan kaçınmak 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ının 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, 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ına dahil edilmeye devam eder.
Başarısız olan ancak SearchAds360Failure
döndürmeyen istekler (ör. ağ düzeyindeki bir hatadan dolayı), kullanıcının günlük işlem kotasına dahil edilmez. Çünkü bu istekler hizmete hiçbir zaman ulaşmayacaktır. Bu duruma ö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 bulunan alan şu hataya neden olabilir:
REQUEST_SIZE_LIMIT_EXCEEDED
.
Aynı hata mesajı, başka sorunlardan da kaynaklanıyor olabilir.
Search Ads 360 Sorgu Dili sorgusu yapılırken bir IN
ifadesi içinde en fazla 20.000 öğe bulunabilir. Bu sınırı aşarsanız FILTER_HAS_TOO_MANY_VALUES
hatası döndürülür.