Kullanım sınırları

Google Slaytlar API paylaşılan bir hizmet olduğundan, kotalar ve sınırlamalar uygularız. tüm kullanıcılar tarafından adil bir şekilde kullanıldığından emin olmak ve Google Workspace sisteminin sağlığı.

Bir kotayı aşarsanız genellikle 429: Too many requests. HTTP durum kodu yanıtı. Bu durumda üstel geri yükleme algoritması'nı sunup tekrar deneyin. daha sonra. Aşağıdaki dakika başına kotalar dahilinde kalmanız koşuluyla, bir gün içinde gönderebileceğiniz istek sayısını sınırlandırmalısınız.

Aşağıdaki tabloda istek sınırları ayrıntılı olarak verilmiştir:

Kotalar
Okuma istekleri
Proje başına dakikada 3000
Her bir proje için kullanıcı başına bir dakika 600
Pahalı okuma istekleri

(presentations.pages.getThumbnail istekleri için kullanılır.)

Proje başına dakikada 300
Her bir proje için kullanıcı başına bir dakika 60
Yazma istekleri
Proje başına dakikada 600
Her bir proje için kullanıcı başına bir dakika 60

Zamana dayalı kota hatalarını çözme

Tüm zaman tabanlı hatalar (X dakika başına en fazla N istek) için kodunuz bu istisnayı yakalar ve cihazlar aşırı yük oluşturmaz.

Üstel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. eksponansiyel geri yükleme algoritması, katlanarak artan bekleme sürelerini kullanarak istekleri yeniden dener maksimum geri yükleme süresine kadar ekleyebilirsiniz. İstekler yine de başarısız olursa, İstek başarılı olana kadar istekler arasındaki gecikmelerin zamanla artması önemlidir.

Örnek algoritma

Üstel geri yükleme algoritması, istekleri katlanarak yeniden dener ve bekleme süresini artırır. maksimum geri yükleme süresine kadar izleyebilirsiniz. Örneğin:

  1. Google Slaytlar API'sine istekte bulunun.
  2. İstek başarısız olursa 1 + random_number_milliseconds bekleyip tekrar deneyin talep ediyor.
  3. İstek başarısız olursa 2 + random_number_milliseconds bekleyip tekrar deneyin talep ediyor.
  4. İstek başarısız olursa 4 + random_number_milliseconds bekleyip tekrar deneyin talep ediyor.
  5. maximum_backoff defaya kadar bu şekilde devam edebilirsiniz.
  6. Beklemeye devam edip maksimum yeniden deneme sayısına kadar tekrar deneyin ancak bekleme süresini artırmayın süre, yeniden denemeler arasındaki süre olarak kabul edilir.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff), Her yineleme (istek) için 1 artan n ile.
  • random_number_milliseconds, şundan küçük rastgele bir milisaniye sayısıdır: eşittir. Bu sayede, çok sayıda istemcinin aynı sunucu tarafından senkronize edildiği ve tüm bunları aynı anda yeniden dener ve istekleri senkronize edilmiş bir şekilde gönderir. dalgalar. random_number_milliseconds değeri her bir tarihten sonra yeniden hesaplanır yeniden deneme isteğinde bulunun.
  • maximum_backoff genellikle 32 veya 64 saniyedir. Uygun değer kullanım alanına göre değişir.

İstemci, maximum_backoff zamanına ulaştıktan sonra yeniden denemeye devam edebilir. Bu noktadan sonra yapılan yeniden denemelerin, geri yükleme süresini artırmaya devam etmesi gerekmez. Örneğin, Örneğin, bir müşteri 64 saniyelik maximum_backoff süresi kullanırsa ve bu süre dolduktan sonra istemci 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcinin süresiz olarak yeniden denemesi engellenmelidir.

Yeniden denemeler ile yeniden deneme sayısı arasındaki bekleme süresi, kullanım alanınıza bağlıdır ve ağ koşulları.

Fiyatlandırma

Google Slaytlar API'nin kullanımı ek ücret ödemeden kullanılabilir. Kotanın aşılması istek sınırları nedeniyle ek ücret alınmaz ve hesabınız faturalandırılmaz.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota istemeniz gerekebilir. artırmış olabilir. Bir hizmet hesabı tarafından yapılan API çağrılarının tek hesap olabilir. Artırılmış kotaya başvurmanız onay almayı garanti etmez. Büyük kota artışlarının onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Google Cloud'u gittikçe daha fazla kotalarınızın artması gerekebilir. Yakında önemli bir etkinlik bekliyorsanız büyük çaplı değişiklikler yapmak için kota düzenlemeleri için istekte bulunma Kotalar sayfasından kullanıma sunduk.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara göz atın: