Kullanım Sınırları

Kullanım sınırları, Google'ın altyapısını, Display & Video 360 API'yi uygun olmayan bir şekilde kullanan otomatik işlemlerden korur. Bir geliştiricinin eylemlerinin topluluğu olumsuz etkileyememesini sağlarlar.

API isteği kota sınırları

Display & Video 360 API'si iki tür sınır kullanır:

  • Toplam kota sınırları (tüm ilgili isteklerin hesaba katıldığı).
  • Yazma yöntemleri için yapılan tüm ilgili isteklerin hesaba katıldığı yazma kotası sınırları. Yazma yöntemleri, kaynakları değiştiren yöntemler (create, patch, delete veya bulkEdit gibi) olarak tanımlanır. Bazı yöntemlerin diğerlerine göre daha fazla yazma kotası tükettiğini unutmayın.

Projeniz bu sınırlardan herhangi birini aşarsa kısıtlama yapılabilir.

Proje genelindeki kota sınırı

Aşağıdaki varsayılan kota sınırları, tüm Display & Video 360 API kaynakları ve yöntemleri tarafından paylaşılır:

  • Proje başına bir dakikada toplam istek sayısı: 1500
  • Proje başına bir dakikada gönderilen yazma isteği sayısı: 700

Reklamverene özel istek kota sınırları

İstek URL'sinde bir reklamveren kimliği belirten yöntemler, ek "proje başına reklamveren başına" kota sınırlarına dahil edilir.

URL yolunda reklamveren kimliği belirtilen tüm istekler (ör. advertisers.lineItems, advertisers.creatives veya advertisers.channels hizmetlerine yapılanlar) aşağıdaki kota sınırlarına dahil edilir:

  • Her projede reklamveren başına bir dakikada toplam istek sayısı: 300
  • Projede reklamveren başına bir dakikada gönderilen yazma isteği sayısı: 150

Yoğun yazma gerektiren yöntemler

Aşağıdaki API yöntemleri yazma yoğundur. Yani, bu yöntemler önemli miktarda ürün kaynağı kullanır ve sonuç olarak diğer yazma isteklerinden daha fazla yazma isteği kotası tüketir.

Yoğun yazma yöntemlerine yapılan istekler yazma isteği kota tüketimi hesaplanırken 5 yazma sorgusu olarak sayılır. Örneğin, bir dakika içinde yapılan 100 standart yazma isteği ve 21 yazma yoğun istek (hiçbiri reklamveren belirtmez) 205 yazma sorgusu (100 + (21 * 5) = 205) olarak sayılır ve dakikada 200 yazma sorgusu olan mevcut genel istek kotası sınırını aşar.

Aşağıdaki yöntemler yazma yoğun olarak kabul edilir:

Kota sınırlarını aşma

Çok düşük bir olasılık da olsa, isteğinizin API istek sınırını aşması nedeniyle başarısız olması durumunda API bir HTTP durum kodu ve hatanın nedenini döndürür. Ayrıca, yanıtın gövdesinde hataya neden olan şeyin ayrıntılı bir açıklaması yer alır.

Aşağıdaki listede, API istek sınırlarının aşılmasından kaynaklanan istek hataları için olası hatalar ve önerilen işlemler gösterilmektedir.

Kod RPC Mesaj Önerilen işlem
429 RESOURCE_EXHAUSTED Kaynak tükendi (ör. kotayı kontrol etme). Google API Konsolu'ndan kullanımınızı inceleyin ve farklı reklamverenler altında yapılan istekleri daha iyi paralel hale getirmek için iş akışınızı değiştirin veya istek gönderme hızınızı daha genel olarak yavaşlatın.

Display & Video 360 API kota sınırları için artış istenemez.