Kotalar

Kotalar, Google altyapısını, Google Bid Manager API'sini uygun olmayan bir şekilde kullanan otomatik işlemlerden korur. Bir geliştiricinin eylemlerinin daha büyük topluluğu olumsuz etkilememesini sağlarlar.

Kota sınırları

Aşağıdaki varsayılan kota sınırları, tüm Bid Manager API kaynakları ve yöntemleri tarafından paylaşılır.

• Proje başına günlük 2.000 istek - artırılabilir.
• Proje başına saniyede 4 sorgu (QPS).
  • Google API Konsolu'nda bu kota Kullanıcı başına dakikada sorgu sayısı olarak adlandırılır ve 240 olarak ayarlanmıştır.

Not: Günlük kotalar (PST) gece yarısında yenilenir.

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

Çok düşük bir ihtimal de olsa, isteğinizin kota 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 hatanın nedeninin ayrıntılı bir açıklaması yer alır. Örnek bir hata yanıtı için Hata Mesajları kılavuzuna bakın.

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

Kod	Neden	Message	Önerilen işlem
403	dailyLimitExceeded	Günlük Sınır Aşıldı	Sorunu gidermeden tekrar denemeyin. Google API Konsolu'ndan kullanımınızı inceleyin ve iş akışınızı daha az istek yapacak şekilde değiştirin. Kullanımınızın makul olduğunu düşünüyorsanız ek kota isteyebilirsiniz.
403	userRateLimitExceeded	Kullanıcı Hız Sınırı Aşıldı	Üstel geri çekilme kullanarak istek gönderme hızınızı düşürün.

Eksponansiyel geri yükleme nedir?

Üstel geri yükleme, istemcinin başarısız bir isteği giderek artan bir süre içinde düzenli olarak yeniden denediği, ağ uygulamaları için standart bir hata işleme stratejisidir. Yüksek hacimli istek veya yoğun ağ trafiği, sunucunun hata döndürmesine neden oluyorsa üstel geri çekilme, bu hataları ele almak için iyi bir strateji olabilir. Bununla birlikte, geçersiz yetkilendirme kimlik bilgileri veya dosya bulunamadı hataları gibi ağ hacmi veya yanıt süreleriyle ilgili olmayan hataları ele almak için uygun bir strateji değildir.

Doğru kullanıldığında üstel geri yükleme özelliği, bant genişliği kullanımının verimliliğini artırır, başarılı bir yanıt almak için gereken istek sayısını azaltır ve eşzamanlı ortamlarda isteklerin işleme hızını en üst düzeye çıkarır.

Basit üstel geri yükleme uygulama akışı aşağıdaki gibidir:

1. API'ye istekte bulunun.
2. İsteği yeniden denemeniz gerektiğini belirten bir HTTP 503 yanıtı alın.
3. 1 saniye +Random_number_milliseconds bekleyin ve isteği yeniden deneyin.
4. İsteği yeniden denemeniz gerektiğini belirten bir HTTP 503 yanıtı alın.
5. 2 saniye +Random_number_milliseconds bekleyin ve isteği yeniden deneyin.
6. İsteği yeniden denemeniz gerektiğini belirten bir HTTP 503 yanıtı alın.
7. 4 saniye +Random_number_milliseconds bekleyin ve isteği yeniden deneyin.
8. İsteği yeniden denemeniz gerektiğini belirten bir HTTP 503 yanıtı alın.
9. 8 saniye + rastgele_sayı_milisaniye cinsinden bekleyin ve isteği yeniden deneyin.
10. İsteği yeniden denemeniz gerektiğini belirten bir HTTP 503 yanıtı alın.
11. 16 saniye + rastgele_sayı_milisaniye cinsinden bekleyin ve isteği yeniden deneyin.
12. Durdur. Hata bildirin veya günlüğe kaydedin.

Yukarıdaki akışta, rastgele_sayı_milisaniye, 1000'den küçük veya 1000'e eşit olan rastgele bir milisaniye sayısıdır. Küçük bir rastgele gecikme uygulamak yükün daha eşit bir şekilde dağıtılmasına ve sunucunun damgalanma olasılığını ortadan kaldırmaya yardımcı olduğundan bu gereklidir. Rastgele_sayı_milisaniye değeri, her beklemenin ardından yeniden tanımlanmalıdır.

Not: Bekleme süresi her zaman (2 ^ n) + rastgele_sayı_millisaniyedir. Burada n, başlangıçta 0 olarak tanımlanan monoton olarak artan bir tam sayıdır. N tam sayısı her iterasyon (her istek) için 1 artar.

Algoritma, n 5 olduğunda sona erecek şekilde ayarlanır. Bu üst sınır, istemcilerin sonsuza kadar yeniden deneme yapmasını engeller ve bir istek "kurtarılamaz hata" olarak kabul edilmeden önce toplamda yaklaşık 32 saniyelik bir gecikmeyle sonuçlanır. Özellikle uzun bir yükleme işlemi devam ediyorsa maksimum yeniden deneme sayısının daha yüksek olması sorun teşkil etmez. Yine de yeniden deneme gecikmesini makul bir süre, örneğin bir dakikadan daha az bir süreyle sınırladığınızdan emin olun.

Ek günlük kota isteme

Uygulamanızın günlük ek kota gerektirdiğini düşünüyorsanız aşağıdaki talimatları uygulayarak daha fazla kota isteyebilirsiniz.

Aşağıdaki talimatlar yalnızca dailyLimitExceeded hatasıyla karşılaşan projeler için geçerlidir. Diğer kota hataları için önerilen işlemler yukarıdaki tabloda ele alınmıştır.

1. Google API Konsolu'nda Bid Manager API'sine gidin.
2. Uygulamanızın beklendiği gibi çalıştığından emin olmak için Metrikler sayfasından kullanım istatistiklerinizi inceleyin. Devam etmeden önce çağrılan yöntemlere çok dikkat edin ve beklenmedik veya aşırı kullanım sorununu ele alın.
3. Kullanım normal görünüyorsa Kotalar sayfasına gidin, Günlük sorgu sayısı'nın yanındaki düzenle simgesini ve "Daha yüksek kotaya başvur" bağlantısını tıklayın.

Artış isteği göndermeden önce bilgileri incelediğinizden ve kota istek formunda yer alan talimatları uyguladığınızdan emin olun.

Not: Bir temsilci ek bilgi toplamak için size ulaşabileceğinden sağladığınız e-posta adresi aktif olarak izlediğiniz bir adres olmalıdır.