Limity chronią infrastrukturę Google przed zautomatyzowanym procesem, który wykorzystuje Groups Settings API w nieodpowiedni sposób. Nadmierna liczba żądań z interfejsu API może być wynikiem nieszkodliwą literówkę lub nieefektywnie zaprojektowany system, który wykonuje niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny, blokowanie ruchu z określonego źródła po osiągnięciu jego określonego poziomu jest niezbędne do utrzymania dobrego stanu systemu Google Workspace.
Nieudane żądania do interfejsu API
W mało prawdopodobnym przypadku, gdy żądanie do interfejsu API zakończy się niepowodzeniem, aplikacja otrzyma kod stanu HTTP.
. Kod stanu HTTP 403 zawiera informacje o błędzie wskazujące, które limity interfejsu API
zostały przekroczone. Odpowiedź pozwala aplikacji niestandardowej wykrywać błędy i podejmować odpowiednie
działania.
Żądania pilne
Jeśli Twoje prośby muszą zostać zrealizowane w określonym czasie, wysyłaj je równolegle. lub wielowątkowości w aplikacji w języku Java lub C#, Możesz na przykład podzielić żądania według miesiąca lub w innym okresie. W przypadku wątków zacznij od 10 wątków, po 1 na żądanie. Rekomendacja wątku wiąże się z kompromisami i nie jest przydatna we wszystkich sytuacjach związanych z interfejsem API. Jeśli liczba liczba żądań jest zbyt duża, występują błędy limitu.
Błędy oparte na czasie
W przypadku wszystkich błędów na podstawie czasu (maksymalnie N rzeczy przez X s na wątek), zwłaszcza
błędów kodu stanu 503, zalecamy, aby kod wychwytał wyjątek i za pomocą funkcji
wykładniczy czas do ponowienia
algorytm, poczekaj niewielkie opóźnienie przed ponowną próbą nieudanego wywołania. Przykład interfejsu Groups Settings API dla
1 wątek to odczekanie 5 sekund i ponowienie nieudanego połączenia. Jeśli żądanie zostanie zrealizowane, powtórz
dla pozostałych wątków. Jeśli drugie żądanie nie powiedzie się, aplikacja powinna zostać
zmniejsza częstotliwość żądania, dopóki nie zostanie ono przetworzone. Na przykład zwiększ
opóźnienie z 5 sekund do 10 sekund i ponów nieudane połączenie. Zdecyduj też ponowienie próby
. Na przykład ponów żądanie 5–7 razy z różnymi opóźnieniami, zanim aplikacja zostanie zrealizowana
zwraca błąd.
Limity
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Zapytania dziennie | Możesz utworzyć do 100 tys. zapytań dziennie. Jeśli potrzebujesz limitu powyżej możesz wysłać prośbę z Strona Limity w konsoli Google Cloud |
| Opis grupy, maksymalny rozmiar | Możesz wpisać opis grupy o długości do 4096 znaków. |
| Nazwa grupy, maksymalny rozmiar | Nazwa grupy może mieć maksymalnie 60 znaków. |
defaultMessageDenyNotificationText |
Tekst powiadomienia może mieć maksymalnie 10 000 znaków. Aby dowiedzieć się więcej na temat:
defaultMessageDenyNotificationText, zobacz
Dokumentacja API
|
maxMessageBytes |
Domyślny maksymalny rozmiar wiadomości to 1 MB. Więcej informacji na temat: maxMessageBytes
można znaleźć w dokumentacji interfejsu API.
|
Limity
| Rodzaje limitów | Ograniczenia i wytyczne |
|---|---|
| Format danych, domyślny |
Domyślny format danych to JSON. Interfejs API obsługuje również format Atom. Pliki JSON i Atom formaty danych obsługują pełne możliwości odczytu i zapisu. Więcej informacji: Formaty danych JSON i Atom. |
| Groups Settings API, włączanie | Przed wywołaniem interfejsu Groups Settings API musisz włączyć interfejs Directory API. Więcej informacji więcej informacji znajdziesz w artykule Włączanie interfejsów Google Workspace API. |