Limity i kwoty chronią infrastrukturę Google przed zautomatyzowanymi procesami, które nieprawidłowo korzystają z interfejsu Reseller API. Nadmierna liczba żądań może wynikać z błędu w pisowni lub nieefektywnej konstrukcji systemu. Aby zapewnić prawidłowe działanie systemu Google Workspace, blokujemy ruch z określonych źródeł, gdy osiągnie on określony poziom. Dzięki temu działania jednego dewelopera nie będą miały negatywnego wpływu na społeczność.
Nieudane żądania do interfejsu API
Jeśli żądanie do interfejsu API nie powiedzie się, aplikacja otrzyma kod stanu HTTP. Kod stanu 403 oznacza nieprawidłowe dane wejściowe, a kod stanu 503 wskazuje, że limity interfejsu API zostały przekroczone. Używaj tych odpowiedzi do wykrywania błędów i podejmowania działań.
Błędy związane z czasem
W przypadku błędów związanych z czasem, zwłaszcza kodów stanu 503, używaj algorytmu wzrastającego czasu do ponowienia. Przed ponowną próbą wykonania nieudanego połączenia poczekaj chwilę. Na przykład poczekaj 5 sekund i spróbuj ponownie. Jeśli się uda, powtórz ten wzorzec w przypadku innych wątków. Jeśli drugie żądanie się nie powiedzie, zmniejsz częstotliwość żądań, dopóki wywołanie nie zakończy się sukcesem. Zalecamy też ustalenie limitu ponownych prób, np. od 5 do 7.
Limity
| Kategorie limitów interfejsu API | Limity |
|---|---|
Subskrypcja purchaseOrderId |
Ta właściwość akceptuje maksymalnie 80 znaków zwykłego tekstu. |
Subskrypcja maxResults |
Ciąg zapytania maxResults może zawierać od 1 do 100 wyników.
Domyślnie wyświetlanych jest 20 wyników.
|
Token przeniesienia (customerAuthToken) |
Token przeniesienia klienta jest ważny przez 30 dni od wygenerowania. |
| Maksymalna liczba użytkowników klienta | W zależności od umowy maksymalna liczba użytkowników może wynosić 50 tys. lub maksymalną liczbę określoną w umowie z odsprzedawcą. |
| Nieautoryzowane żądania | Google nie zezwala na nieautoryzowane żądania przesyłane do interfejsu Reseller API. Żądanie jest nieautoryzowane, jeśli nie podano tokena autoryzacji. Więcej informacji znajdziesz w artykule Uwierzytelnianie i autoryzacja. |
Inne rodzaje limitów
| Inne rodzaje limitów | Ograniczenia i wskazówki |
|---|---|
| Format danych |
Format danych to JavaScript Object Notation (JSON).
JSON to popularny format internetowy do reprezentowania dowolnych struktur danych. Jest to niezależny od języka format tekstowy, który wykorzystuje konwencje znane programistom języków z rodziny C, takich jak C, C++, C#, Java, JavaScript, Perl i Python. |
| Format godziny | Daty i godziny są podawane w milisekundach w konwerterze epok. Ten format dotyczy czasu utworzenia subskrypcji, czasu rozpoczęcia i zakończenia zobowiązania dotyczącego abonamentu oraz czasu zakończenia bezpłatnego okresu próbnego. |