Kullanım Sınırları

Kullanım sınırları, Google'ın altyapısını Display & Video 360 API'yi uygunsuz bir şekilde kullanan otomatik işlemlerden korur. Bir geliştiricinin eylemlerinin daha geniş topluluğu olumsuz yönde etkilemesini önler.

API istek kotası sınırları

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

  • Tüm ilgili isteklerin dahil edildiği toplam kota sınırları.
  • Yazma yöntemleri için yapılan tüm alakalı isteklerin hesaba katıldığı yazma kotası sınırları. Yazma yöntemleri, kaynakları değiştiren yöntemler (ör. create, patch, delete veya bulkEdit) 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 sınırlama uygulanabilir.

Proje genelinde 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 dakikada toplam istek sayısı: 1500
  • Proje başına dakikada yazma isteği sayısı: 700

Reklamverene özgü istek kotası sınırları

İstek URL'sinde reklamveren kimliği belirten yöntemler, ek "reklamveren başına proje başına" kota sınırlarına göre sayılır.

URL yollarında reklamveren kimliği belirtilen tüm istekler (ör. advertisers.lineItems, advertisers.creatives veya advertisers.channels hizmetlerine yapılan istekler) aşağıdaki kota sınırlarını etkiler:

  • Proje başına reklamveren başına dakika başına toplam istek sayısı: 300
  • Proje başına reklamveren başına dakikada yazma isteği sayısı: 150

Yoğun yazma yöntemleri

Aşağıdaki API yöntemleri yoğun yazma işlemi gerçekleştirir. Yani ö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 kotası 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 yoğun yazma isteği (hiçbiri reklamveren belirtmez) 205 yazma sorgusu (100 + (21 * 5) = 205) olarak sayılır ve dakika başına 200 yazma sorgusu olan mevcut genel istek kotası sınırını aşar.

Aşağıdaki yöntemler yoğun yazma işlemi gerektirir:

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

İsteğinizin API istek sınırını aşması nedeniyle başarısız olması ihtimaline karşı API, bir HTTP durum kodu ve hatanın nedenini döndürür. Ayrıca, yanıtın gövdesinde hataya neyin neden olduğunun ayrıntılı bir açıklaması bulunur.

Aşağıdaki listede, API istek sınırlarının aşılması nedeniyle oluşan istek hatalarıyla ilgili olası hatalar ve önerilen işlemler gösterilmektedir.

Kod TBG Mesaj Önerilen işlem
429 RESOURCE_EXHAUSTED Kaynak tükendi (ör. kotayı kontrol edin). Google API Console'dan kullanımınızı inceleyin ve farklı reklamverenler altında yapılan istekleri daha iyi paralelleştirecek veya genel olarak istek gönderme hızınızı yavaşlatacak şekilde iş akışınızı değiştirin.

Display & Video 360 API kota sınırları için artış isteğinde bulunulamaz.