Google Forms API paylaşılan bir hizmet olduğundan, tüm kullanıcılar tarafından adil bir şekilde kullanılmasını sağlamak ve Google Workspace sisteminin genel sağlığını korumak için kotalar ve sınırlamalar uygularız.
Bir kotayı aşarsanız genellikle 429: Too many requests HTTP durum kodu yanıtı alırsınız. Bu durumda, eksponansiyel geri yükleme algoritması kullanmanız ve daha sonra tekrar denemeniz gerekir. Aşağıdaki dakika başına kotaları aşmadığınız sürece, bir günde yapabileceğiniz istek sayısıyla ilgili bir sınır yoktur.
Not: Form izlemeleri için ek sınırlamalar vardır. Daha fazla bilgi için Push bildirimlerini ayarlama ve alma başlıklı makaleyi inceleyin.
Aşağıdaki tabloda istek sınırları ayrıntılı olarak açıklanmıştır:
| Kotalar | |||||||
|---|---|---|---|---|---|---|---|
| Okuma istekleri |
|
||||||
|
Yüksek maliyetli okuma istekleri
( |
|
||||||
| Yazma istekleri |
|
||||||
Zamana dayalı kota hatalarını çözme
Zamana dayalı tüm hatalar için (X dakikada en fazla N istek) kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmamasını sağlamak için kesilmiş eksponansiyel geri yükleme kullanmasını öneririz.
Eksponansiyel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, istekler arasında eksponansiyel olarak artan bekleme süreleri kullanarak istekleri yeniden dener. Bu süre, maksimum geri yükleme süresine kadar artar. İstekler hâlâ başarısız oluyorsa istekler arasındaki gecikme süresinin, istek başarılı olana kadar zaman içinde artması önemlidir.
Örnek algoritma
Eksponansiyel geri yükleme algoritması, istekleri eksponansiyel olarak yeniden dener ve yeniden denemeler arasındaki bekleme süresini maksimum geri yükleme süresine kadar artırır. Örneğin:
- Google Forms API'ye istekte bulunma
- İstek başarısız olursa 1 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 2 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 4 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - Bu şekilde
maximum_backoffkez devam eder. - Maksimum deneme sayısına ulaşana kadar beklemeye ve yeniden denemeye devam edin ancak denemeler arasındaki bekleme süresini artırmayın.
Bu örnekte:
- Bekleme süresi
min(((2^n)+random_number_milliseconds), maximum_backoff)olupnher iterasyon (istek) için 1 artırılır. random_number_milliseconds, 1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu sayede, birçok istemcinin bir durum nedeniyle senkronize edildiği ve hepsinin aynı anda yeniden deneme yaparak senkronize dalgalar halinde istek gönderdiği durumlar önlenir.random_number_millisecondsdeğeri, her yeniden deneme isteğinden sonra yeniden hesaplanır.maximum_backoffgenellikle 32 veya 64 saniyedir. Uygun değer, kullanım alanına bağlıdır.
İstemci, maximum_backoff süresine ulaştıktan sonra yeniden denemeye devam edebilir.
Bu noktadan sonraki yeniden denemelerde bekleme süresinin artırılmasına gerek yoktur. Örneğin, bir istemci 64 saniyelik bir maximum_backoff süresi kullanıyorsa bu değere ulaştıktan sonra her 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemesi engellenmelidir.
Yeniden denemeler arasındaki bekleme süresi ve yeniden deneme sayısı, kullanım alanınıza ve ağ koşullarınıza bağlıdır.
Fiyatlandırma
Google Forms API'nin tüm standart kullanımları ek ücret ödemeden kullanılabilir. Kota istek sınırlarının aşılması durumunda 2026'nın ilerleyen dönemlerinde Google Cloud Faturalandırma Hesabınızdan ücret alınması planlanmaktadır. Daha fazla bilgi için Temsilci araçları ve API'ler için Google Workspace standartlaştırılmış modeli başlıklı makaleyi inceleyin.
Kota artışı isteme
Projenizin kaynak kullanımına bağlı olarak kota düzenlemesi isteğinde bulunabilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrılarının tek bir hesap kullandığı kabul edilir. Kota düzenlemesi başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil etmez. Kota değerini önemli ölçüde artıracak kota ayarlama isteklerinin onaylanması daha uzun sürebilir.
Her projenin kotası aynı değildir. Zaman içinde Google Cloud'u daha fazla kullandıkça kota değerlerinizi artırmanız gerekebilir. Kullanımda kayda değer bir artış bekliyorsanız Google Cloud Console'daki Kotalar ve Sistem Sınırları sayfasından proaktif olarak kota düzenlemesi isteyebilirsiniz.
Daha fazla bilgi için aşağıdaki kaynaklara göz atın: