Ograniczenia i limity chronią infrastrukturę Google przed automatycznym procesem, który korzysta z interfejsu Enterprise License Manager API w nieprawidłowy sposób. Nadmierna liczba żądań z interfejsu API może wynikać z nieszkodliwej literówki lub nieskutecznie zaprojektowanego systemu, który wykonuje niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny blokowanie ruchu z określonego źródła po osiągnięciu określonego poziomu jest niezbędne dla ogólnego stanu systemu Google Workspace. Dzięki temu działania danego dewelopera nie wpływają negatywnie na całą społeczność.
W mało prawdopodobnym przypadku niepowodzenia żądania do interfejsu API otrzymasz odpowiedź z kodem stanu HTTP. Kod stanu 403 zawiera informacje o błędach związanych z nieprawidłowymi danymi, a kod stanu HTTP 503 – informacje o błędzie wskazujące, które limity interfejsu API zostały przekroczone. Dzięki tym odpowiedziom Twoja aplikacja może wykryć te błędy i podjąć odpowiednie działania.
Jeśli prośby mają zostać zrealizowane w ustalonym czasie, wyślij je zbiorczo. W zależności od przeznaczenia interfejsu API i tego, czy liczba żądań będzie zbyt duża, wystąpią błędy limitu.
Jeśli nie możesz korzystać z zalecanej funkcji żądań zbiorczych interfejsu API, użyj algorytmu wykładniczego ponowienia. W przypadku wszystkich błędów opartych na czasie (maksymalnie N rzeczy przez X sekund w wątku), a zwłaszcza błędów kodu stanu 503, zalecamy wychwycenie wyjątku i za pomocą algorytmu wykładniczego ponowienia poczekaj z niewielkim opóźnieniem, zanim spróbujesz ponownie wykonać nieudane wywołanie. Przykładem interfejsu Enterprise License Manager API w jednym wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie zostanie zrealizowane, powtórz ten wzorzec w przypadku innych wątków. Jeśli drugie żądanie nie powiedzie się, aplikacja powinna ograniczyć częstotliwość do tego żądania. Możesz na przykład zwiększyć początkowe 5-sekundowe opóźnienie do 10 sekund i ponownie spróbować wykonać nieudane połączenie. Ustal też limit ponownych prób. Na przykład ponów próbę 5–7 razy z różnymi czasami opóźnienia, zanim aplikacja zwróci użytkownikowi błąd.
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Zapytania na sekundę (QPS) | Limit zapytań na sekundę wynosi 1. |
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Ciąg zapytania maxResults | Maksymalny rozmiar pola maxResults to 100. |
| Inne typy limitów | Ograniczenia i wytyczne |
|---|---|
| Żądania zbiorcze |
Interfejs API obsługuje wysyłanie żądań zbiorczych. |
| Format danych w odpowiedziach interfejsu API | Format danych odpowiedzi to JavaScript Object Notation (JSON). |
| Włączanie interfejsu Enterprise License Manager API | Zanim zaczniesz wywoływać interfejs Enterprise License Manager API, musisz włączyć interfejs API do obsługi administracyjnej. W panelu sterowania przejdź na stronę Ustawienia na karcie Użytkownicy i grupy i włącz interfejs API do obsługi administracyjnej. Zapisz zmiany. Dodatkowo musisz włączyć i aktywować usługę Grupy dyskusyjne Google. |
| Nieautoryzowane żądania | Interfejs API nie akceptuje żadnych nieautoryzowanych żądań. Jeśli nie podano tokena autoryzacji, żądanie jest uznawane za nieautoryzowane. Więcej informacji znajdziesz w sekcji Autoryzacja żądań . |