Limity i limity interfejsu API chronią infrastrukturę Google przed zautomatyzowanym procesem, który wykorzystuje interfejs API Resellera w nieodpowiedni sposób. Nadmierne żądania z interfejsu API mogą być wynikiem nieszkodliwego błędu lub nieefektywnie zaprojektowanego systemu, który wysyła niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny blokowanie ruchu z określonego źródła, gdy osiągnie on określony poziom, jest konieczne dla ogólnej kondycji systemu Google Workspace. Dzięki temu działania jednego dewelopera nie mogą negatywnie wpłynąć na całą społeczność.
Nieudane żądania do interfejsu API
W nieprawdopodobnym przypadku, gdy żądanie interfejsu API zakończy się niepowodzeniem, aplikacja otrzyma odpowiedź z kodem stanu HTTP. Kod stanu 403 zawiera informacje o nieprawidłowym wejściu, a kod stanu HTTP 503 zawiera informacje o tym, które limity interfejsu API zostały przekroczone. Te odpowiedzi umożliwiają aplikacji niestandardowej wykrywanie tych błędów i podejmowanie odpowiednich działań.
Błędy czasowe
W przypadku wszystkich błędów zależnych od czasu (maksymalnie N elementów przez N sekund na wątek), zwłaszcza błędów z kodem stanu 503, zalecamy, aby kod przechwytywał wyjątek i za pomocą algorytmu wygasania wykładniczego czekał przez krótki czas, zanim ponownie spróbuje wykonać nieudane wywołanie. Przykład wywołania interfejsu API Resellera w jednym wątku: zaczekaj 5 sekund i ponownie wywołaj nieudane wywołanie. Jeśli żądanie zostanie zrealizowane, powtórz ten wzór w przypadku pozostałych wątków. Jeśli druga prośba nie powiedzie się, aplikacja powinna zmniejszyć częstotliwość żądania do momentu, aż połączenie się powiedzie. Możesz na przykład zwiększyć początkowe opóźnienie z 5 do 10 sekund i ponownie spróbować wykonać nieudane połączenie. Określ też limit prób.
Na przykład przed zwróceniem błędu użytkownikowi aplikacja może 5–7 razy powtarzać żądanie z różnymi opóźnieniami.
Limity
| Kategorie ograniczeń interfejsu API | Limity |
|---|---|
Subskrypcja purchaseOrderId |
Ta właściwość może zawierać maksymalnie 80 znaków zwykłego tekstu. |
Subskrypcja maxResults |
Ciąg zapytania maxResults może zawierać od 1 do 100 wyników.
Wartość domyślna to 20 wyników.
|
Token przeniesienia (customerAuthToken) |
Token przeniesienia klienta jest ważny przez 30 dni od wygenerowania. |
| Maksymalna liczba użytkowników na klienta | W zależności od umowy maksymalna liczba użytkowników może wynosić 50 tys. lub maksymalną liczbę zdefiniowaną w umowie z resellerem. |
| Nieautoryzowane żądania | Google nie zezwala na nieautoryzowane żądania do interfejsu Reseller API. Żądanie jest uważane za nieautoryzowane, jeśli nie zostanie podany token autoryzacji. Więcej informacji znajdziesz w artykule Więcej informacji o uwierzytelnianiu i autoryzacji. |
Inne typy limitów
| Inne typy limitów | Ograniczenia i wytyczne |
|---|---|
| Format danych |
Format danych to JSON (JavaScript Object Notation).
JSON to popularny format internetowy, który umożliwia reprezentowanie dowolnych struktur danych. JSON to format tekstowy, który jest całkowicie niezależny od języka, ale wykorzystuje konwencje znane programistom znającym języki z rodziny C, w tym C, C++, C#, Java, JavaScript, Perl i Python. |
| Format godziny | Wszystkie daty i godziny są podane w konwerterze epoki w milisekundach. Ten format dotyczy wartości czasu utworzenia subskrypcji, czasu rozpoczęcia i zakończenia zobowiązania w ramach abonamentu oraz czasu zakończenia 30-dniowego bezpłatnego okresu próbnego. |