Limity wykorzystania

Interfejs API Prezentacji Google jest usługą współdzieloną, dlatego stosujemy limity. by zapewnić, że wszyscy użytkownicy będą z niej uczciwie korzystać, a także i kondycję systemu Google Workspace.

Po przekroczeniu limitu otrzymasz zazwyczaj powiadomienie 429: Too many requests Odpowiedź kodu stanu HTTP. W takim przypadku należy użyć tagu algorytm wykładniczego ponowienia i spróbuj ponownie później. Jeśli nie zmieścisz się w poniższych limitach na minutę, nie będzie Ograniczenie liczby żądań, które możesz wykonać dziennie.

W tabeli poniżej znajdziesz szczegółowe informacje o limitach żądań:

Limity
Żądania odczytu
Za minutę na projekt 3000
Za minutę na użytkownika na projekt 600
Koszty żądań odczytu

(Używane w przypadku presentations.pages.getThumbnail żądań.)

Za minutę na projekt 300
Za minutę na użytkownika na projekt 60
Żądania zapisu
Za minutę na projekt 600
Za minutę na użytkownika na projekt 60

Rozwiązywanie błędów limitów czasowych

W przypadku wszystkich błędów zależnych od czasu (maksymalnie N żądań na X min) zalecamy kod przechwytuje ten wyjątek i używa obciętego wykładniczego czasu do ponowienia, aby zapewnić urządzenia nie generują nadmiernego obciążenia.

Wykładniczy czas do ponowienia to standardowa strategia obsługi błędów w aplikacjach sieciowych. An algorytm wykładniczego ponowienia ponawia próby żądania, wykorzystując wykładniczo wydłużające się czasy oczekiwania między żądaniami aż do maksymalnego czasu ponowienia. Jeśli żądania nadal nie zostaną zrealizowane, ważne, że opóźnienia między prośbami zwiększają się z czasem do momentu, gdy żądanie zostanie rozpatrzone pozytywnie.

Przykładowy algorytm

Wykładniczy algorytm do ponawiania wielokrotnie ponawia próby żądania, zwiększając czas oczekiwania. między ponownymi próbami aż do maksymalnego czasu ponowienia. Na przykład:

  1. Prześlij żądanie do interfejsu API Prezentacji Google.
  2. Jeśli żądanie się nie powiedzie, poczekaj 1 + random_number_milliseconds i spróbuj ponownie do danej prośby.
  3. Jeśli żądanie się nie powiedzie, poczekaj 2 + random_number_milliseconds i spróbuj ponownie do danej prośby.
  4. Jeśli żądanie się nie powiedzie, poczekaj 4 + random_number_milliseconds i spróbuj ponownie do danej prośby.
  5. I tak dalej, maksymalnie maximum_backoff raz.
  6. Zaczekaj i ponawiaj próby aż do określonej maksymalnej liczby prób, ale nie wydłużaj czasu oczekiwania między kolejnymi próbami.

gdzie:

  • Czas oczekiwania wynosi min(((2^n)+random_number_milliseconds), maximum_backoff), z wartością n przyrostową o 1 dla każdej iteracji (żądania).
  • random_number_milliseconds jest losową liczbą milisekund mniejszą niż lub równy 1000. Pozwala to uniknąć przypadków, w których wiele klientów jest zsynchronizowanych przez w jakiejś sytuacji i spróbuje ponownie jednocześnie wysyłać żądania fale. Wartość funkcji random_number_milliseconds jest obliczana ponownie po każdej spróbuj jeszcze raz.
  • maximum_backoff zwykle trwa 32 lub 64 sekundy. Odpowiednia wartość zależy od przypadku użycia.

Klient może ponawiać próby po osiągnięciu maximum_backoff czasu. Ponowne próby po tym punkcie nie muszą przez cały czas wydłużać czasu do ponowienia. Dla: np. jeśli klient używa czasu maximum_backoff wynoszącego 64 sekundy, a następnie po osiągnięciu tę wartość, klient może ponawiać próby co 64 sekundy. W pewnym momencie nie powinno się uniemożliwić ponawianiu prób w nieskończoność.

Czas oczekiwania między ponownymi próbami a liczba ponownych prób zależy od konkretnego przypadku użycia i stanu sieci.

Ceny

Z interfejsu API Prezentacji Google można korzystać bez dodatkowych opłat. Przekroczenie limitu nie wiąże się z dodatkowymi opłatami, a Twoje konto nie jest obciążane.

Poproś o zwiększenie limitu

W zależności od wykorzystania zasobów projektu możesz poprosić o zwiększenie limitu wzrost. Uznaje się, że wywołania interfejsu API przez konto usługi korzystają z metody jedno konto. Zgłoszenie prośby o zwiększenie limitu nie gwarantuje jego zatwierdzenia. Duże Zatwierdzenie zwiększenia limitu może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. Ponieważ coraz częściej korzystasz z Google Cloud w ramach limity czasu mogą wymagać zwiększenia limitu. Jeśli spodziewasz się w nadchodzącym okresie wzrost wykorzystania, możesz proaktywnie poproś o korektę limitu na stronie Limity w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach: