Ograniczenia i limity chronią infrastrukturę Google przed automatycznym procesem, który korzysta z interfejsu Seller 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. Bez względu na przyczynę zablokowanie ruchu z określonego źródła po osiągnięciu określonego poziomu jest konieczne dla ogólnego stanu systemu Google Workspace. Dzięki temu działania jednego dewelopera nie wpłyną negatywnie na całą społeczność.
Nieudane żądania do interfejsu API
W mało prawdopodobnym przypadku niepowodzenia żądania do interfejsu API aplikacja otrzyma odpowiedź z kodem stanu HTTP. Kod stanu 403 zawiera informacje o błędach dotyczących nieprawidłowych danych wejściowych, a kod stanu HTTP 503 – informacje o błędach wskazujące, które limity interfejsu API zostały przekroczone. Te odpowiedzi pozwalają aplikacji niestandardowej wykryć te błędy i podjąć odpowiednie działanie.
Błędy czasowe
W przypadku wszystkich błędów, które są zależne od czasu (maksymalnie N sekundy w wątku), a zwłaszcza błędów kodu stanu 503, zalecamy wychwycenie wyjątku i użycie algorytmu wykładniczego ponowienia, po którym odczekaj chwilę, zanim spróbujesz ponownie wykonać nieudane wywołanie. Przykładem interfejsu API sprzedawcy dla jednego wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie zostanie zrealizowane, powtórz ten wzorzec w przypadku pozostałych wątków. Jeśli drugie żądanie się nie powiedzie, aplikacja powinna skalować się w obrębie częstotliwości żądań, aż wywołanie się powiedzie. Na przykład zwiększ początkowe 5-sekundowe opóźnienie do 10 sekund i spróbuj ponownie wykonać nieudane wywołanie. Ustal też limit ponownych prób.
Na przykład ponawiaj żądanie 5–7 razy z różnymi czasami opóźnienia, zanim aplikacja zwróci użytkownikowi błąd.
Limity
| Kategorie limitów 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ścią domyślną jest 20 wyników.
|
Token przeniesienia (customerAuthToken) |
Token przeniesienia klienta jest ważny przez 30 dni po jego wygenerowaniu. |
| Maksymalna liczba użytkowników dla klienta | W zależności od umowy maksymalna liczba użytkowników może wynosić 50 tys. lub maksymalna określona w umowie sprzedawcy. |
| Nieautoryzowane żądania | Google nie zezwala na nieautoryzowane żądania wysyłane do interfejsu Seller API. Jeśli nie podano tokena autoryzacji, żądanie jest uznawane za nieautoryzowane. Więcej informacji znajdziesz w artykule o uwierzytelnianiu i autoryzacji. |
Inne typy limitów
| Inne typy limitów | Ograniczenia i wytyczne |
|---|---|
| Format danych |
Format danych jest w formacie JSON obiektu JavaScript Object Notation.
JSON to popularny format internetowy, który umożliwia prezentowanie dowolnych struktur danych. JSON to format tekstowy, który jest całkowicie niezależny od języka, ale korzysta z konwencji znanych dla programistów z rodziny C, takich jak C, C++, C#, Java, JavaScript, Perl i Python. |
| Format godziny | Wszystkie daty są podawane w konwerterze epoki w milisekundach. Ten format ma zastosowanie do wartości czasu utworzenia subskrypcji, czasu rozpoczęcia i zakończenia zobowiązania abonamentu oraz czasu zakończenia 30-dniowego bezpłatnego okresu próbnego. |