Limity wykorzystania

Interfejs API Google Forms to usługa współdzielona, dlatego stosujemy limity i ograniczenia, aby zapewnić sprawiedliwe korzystanie z niej przez wszystkich użytkowników oraz chronić ogólną wydajność systemu Google Workspace.

Jeśli przekroczysz limit, zwykle otrzymasz odpowiedź z kodem stanu HTTP 429: Too many requests. W takim przypadku użyj wzrastającego algorytmu czasowego odstępu i spróbuj ponownie później. Jeśli nie przekroczysz limitów na minutę podanych poniżej, nie będziesz mieć limitu liczby żądań, które możesz wysłać w ciągu dnia.

Uwaga: obserwowanie formularzy ma dodatkowe limity. Więcej informacji znajdziesz w artykule Konfigurowanie i odbieranie powiadomień push.

W tabeli poniżej znajdziesz limity dotyczące żądań:

Limity
Żądania odczytu
Na dzień na projekt Bez ograniczeń
Na minutę na projekt 975
Na minutę na użytkownika na projekt 390
Kosztowe żądania odczytu

(używane do żądań forms.responses.list).

Na dzień na projekt Bez ograniczeń
Na minutę na projekt 450
Na minutę na użytkownika na projekt 180
Żądania zapisu
Na dzień na projekt Bez ograniczeń
Na minutę na projekt 375
Na minutę na użytkownika na projekt 150

Rozwiązywanie błędów związanych z limitem czasowym

W przypadku wszystkich błędów związanych z czasem (maksymalnie N żądań na X minut) zalecamy, aby kod przechwytywał wyjątki i używał odciętej ujemnej funkcji wykładniczej, aby urządzenia nie generowały nadmiernego obciążenia.

Wzrostowy czas do ponowienia to standardowa strategia obsługi błędów w przypadku aplikacji sieciowych. Algorytm wzrastającego czasu do ponowienia powtarza żądania, zwiększając wykładniczo czas oczekiwania między żądaniami do maksymalnego czasu do ponowienia. Jeśli żądania nadal nie działają, ważne jest, aby opóźnienia między żądaniami zwiększały się z czasem, aż żądanie zostanie zrealizowane.

Przykładowy algorytm

Algorytm Exponential back-off powtarza żądania wykładniczo, zwiększając czas oczekiwania między próbami do maksymalnego czasu oczekiwania. Na przykład:

  1. Prześlij żądanie do interfejsu API Formularzy Google.
  2. Jeśli prośba się nie powiedzie, odczekaj 1 + random_number_milliseconds i ponownie ją wyślij.
  3. Jeśli prośba się nie powiedzie, odczekaj 2 + random_number_milliseconds i spróbuj ponownie.
  4. Jeśli prośba zakończy się niepowodzeniem, odczekaj 4 + random_number_milliseconds i ponownie ją wyślij.
  5. I tak dalej, aż do maximum_backoff razy.
  6. Kontynuuj oczekiwanie i próby do maksymalnej liczby prób, ale nie wydłużaj czasu oczekiwania pomiędzy próbami.

gdzie:

  • Czas oczekiwania wynosi min(((2^n)+random_number_milliseconds), maximum_backoff), a wartość n zwiększa się o 1 za każdą iterację (żądanie).
  • random_number_milliseconds to losowa liczba w milisekundach mniejsza lub równa 1000. Pomaga to uniknąć sytuacji, w której wiele klientów jest synchronizowanych w jakiejś sytuacji i wszystkie próbują ponownie od razu, wysyłając żądania w zsynchronizowanych falach. Wartość random_number_milliseconds jest ponownie obliczana po każdym żądaniu ponownego próby.
  • maximum_backoff wynosi zwykle 32 lub 64 sekund. Odpowiednia wartość zależy od przypadku użycia.

Klient może kontynuować próby po upływie czasu maximum_backoff. Ponowne próby po tym punkcie nie muszą zwiększać czasu oczekiwania. Jeśli na przykład klient używa wartości maximum_backoff wynoszącej 64 sekundy, po osiągnięciu tej wartości może próbować ponownie co 64 sekundy. W pewnym momencie należy zablokować klientom możliwość nieograniczonego powtarzania prób.

Czas oczekiwania między próbami i ich liczba zależą od przypadku użycia i warunków sieci.

Ceny

Korzystanie z interfejsu Google Forms API jest bezpłatne. Przekroczenie limitu próśb o przekroczenie limitu nie powoduje dodatkowych opłat, a Twoje konto nie zostanie obciążone.

Poproś o zwiększenie limitu

W zależności od wykorzystania zasobów w projekcie możesz poprosić o zwiększenie limitu. Wywołania interfejsu API przez konto usługi są uznawane za korzystanie z jednego konta. Wysłanie wniosku o zwiększenie limitu nie gwarantuje jego zatwierdzenia. Zatwierdzenie dużego zwiększenia limitu może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. W miarę zwiększania się wykorzystania Google Cloud może być konieczne zwiększenie limitów. Jeśli spodziewasz się znacznego wzrostu wykorzystania, możesz poprosić o zmianę limitów na stronie Limity w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach: