Limity i limity chronią infrastrukturę Google przed automatycznym procesem, który w nieodpowiedni sposób korzysta z interfejsu Groups Settings API. Nadmierna liczba żądań z interfejsu API może wynikać z nieszkodliwej literówki lub nieskutecznego systemu, który wykonuje niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny zablokowanie ruchu z określonego źródła po osiągnięciu określonego poziomu jest konieczne dla ogólnego stanu systemu Google Workspace.
Nieudane żądania do interfejsu API
W mało prawdopodobnym przypadku niepowodzenia żądania do interfejsu API aplikacja otrzyma odpowiedź z kodem stanu HTTP. Kod stanu HTTP 403 zawiera informacje o błędzie wskazujące, które limity interfejsów API zostały przekroczone. Odpowiedź pozwala niestandardowej aplikacji wykrywać błędy i podejmować odpowiednie działania.
Żądania pilne dotyczące czasu
Jeśli żądania muszą zostać zrealizowane w ustalonym czasie, wysyłaj je równolegle lub korzystaj z wielu wątków w aplikacji w języku Java lub C#. Możesz na przykład podzielić żądania według miesiąca lub innego okresu. W przypadku wątków spróbuj zacząć od 10 wątków – po 1 wątku na żądanie. Rekomendacja dotycząca wątków ma wady i nie jest przydatna we wszystkich sytuacjach związanych z interfejsami API. Jeśli liczba żądań staje się zbyt duża, występują błędy limitu.
Błędy czasowe
W przypadku wszystkich błędów, które są uzależnione od czasu (maksymalnie N rzeczy przez X sekund w wątku), zwłaszcza w przypadku błędów kodu stanu 503, zalecamy wychwycenie kodu wyjątku i za pomocą algorytmu algorytmu wykładniczego poczekać z niewielkim opóźnieniem przed ponowną próbą nieudanego wywołania. Przykładem interfejsu Groups Settings API w jednym wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie się powiedzie, powtórz ten wzorzec dla innych wątków. Jeśli drugie żądanie się nie powiedzie, aplikacja powinna zmniejszyć częstotliwość wysyłania aż do pomyślnego wyniku. Możesz na przykład zwiększyć początkowe opóźnienie o 5 sekund do 10 sekund i ponowić nieudane połączenie. Ustal też limit ponownych prób. Na przykład ponawiaj żądanie 5–7 razy z różnymi czasami opóźnienia, zanim aplikacja zwróci błąd użytkownikowi.
Limity
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Zapytania dziennie | Możesz utworzyć do 100 tys. zapytań dziennie. Jeśli potrzebujesz pojemności powyżej tego limitu, możesz wysłać prośbę na stronie Limity w konsoli Google Cloud |
| Opis grupy, maksymalny rozmiar | Możesz wpisać opis grupy o długości do 300 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. Więcej informacji o właściwości defaultMessageDenyNotificationText znajdziesz w dokumentacji interfejsu API.
|
maxMessageBytes |
Domyślny maksymalny rozmiar wiadomości to 1 MB. Więcej informacji o właściwości maxMessageBytes znajdziesz w dokumentacji interfejsu API.
|
Ograniczenia
| Rodzaje limitów | Ograniczenia i wytyczne |
|---|---|
| Format danych, domyślny |
Domyślny format danych to JSON. Interfejs API obsługuje też format Atom. Zarówno formaty danych JSON, jak i Atom obsługują pełne możliwości odczytu i zapisu. Więcej informacji znajdziesz w artykule o formatach 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 znajdziesz w artykule Włączanie interfejsów Google Workspace API. |