Limity chronią infrastrukturę Google przed automatycznym procesem, który w niewłaściwy sposób korzysta z interfejsu Admin Settings API. Zbyt wiele żądań z interfejsu API może wynikać z nieszkodliwej literówki lub niesprawnie zaprojektowanego systemu, który generuje niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny blokowanie ruchu z określonego źródła jest niezbędne do utrzymania ogólnego stanu systemu Google Workspace. Dzięki temu działania dewelopera nie wpłyną negatywnie na większą społeczność.
W bardzo rzadkich przypadkach, gdy nie uda się zrealizować żądania interfejsu API, otrzymasz odpowiedź z kodem stanu HTTP. Kod stanu 403 zawiera informacje o błędach dotyczące nieprawidłowych danych wejściowych, a kod stanu HTTP 503 zawiera informacje o błędzie, które wskazują przekroczenie limitów interfejsu API. Te odpowiedzi pozwalają aplikacji niestandardowej wykryć te błędy i podjąć odpowiednie działania.
Jeśli żądania należy zrealizować w określonym czasie, wyślij je równolegle lub użyj wielu wątków w aplikacji w języku Java lub C#. Możesz na przykład podzielić prośby według miesiąca lub innego okresu. W przypadku wątków spróbuj rozpocząć od 10 wątków, po 1 na wątek na żądanie. Pamiętaj, że rekomendacja dotycząca wątków ma wady i nie jest przydatna we wszystkich sytuacjach dotyczących interfejsu API. Jeśli liczba żądań przekroczy limit, wystąpią błędy limitu.
W przypadku wszystkich błędów, które są ograniczone czasowo (maksymalnie N oznaczeń przez X sekund na wątek), szczególnie błędów kodu stanu 503, zalecamy wychwycenie tego wyjątku i użycie algorytmu wykładniczego ponowienia, zanim spróbujesz ponownie nawiązać połączenie z niewielkim opóźnieniem. Przykład w interfejsie Email Settings API z jednego wątku polega na odczekaniu 5 sekund i ponowieniu nieudanego wywołania. Jeśli żądanie się powiedzie, powtórz ten wzorzec dla pozostałych wątków. Jeśli drugie żądanie się nie powiedzie, aplikacja powinna zmniejszać częstotliwość żądania do momentu nawiązania wywołania. Na przykład zwiększ czas oczekiwania na 5 sekund na 10 sekund i spróbuj ponownie. Określ też limit ponawiania próby. Na przykład spróbuj wysłać żądanie jeszcze 5–7 razy z różnym opóźnieniem, zanim aplikacja zwróci użytkownikowi błąd.
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Tokeny uwierzytelniania ClientLogin | Ważny przez 24 godziny. Błąd to „Token 401 wygasł”. |
| Generowanie kluczy publicznych i prywatnych | Za pomocą dostawcy tożsamości wygeneruj zestaw kluczy publicznych i prywatnych za pomocą algorytmów DSA lub RSA. Klucz publiczny jest w formacie certyfikatu X.509. Więcej informacji o kluczach logowania jednokrotnego opartych na SAML znajdziesz w artykule Generowanie kluczy i certyfikatów dla usługi logowania jednokrotnego Google Workspace. |
| Logo | Plik obrazu logo konta może mieć format JPEG, PNG lub GIF. Zalecany rozmiar to 143 x 59 pikseli, a plik powinien być mniejszy niż 20 KB. Korzystając z niestandardowych logo, musisz przestrzegać Warunków korzystania z usług Google. Nie używaj też logo Google, logo Gmaila ani żadnych innych logo Google. Więcej informacji znajdziesz w artykule Zasady dotyczące logo i strony docelowej. |
| Biała lista nadawców | Biała lista nadawców to adres IP maski sieci w formacie ClassCID Inter-Route (Classless Inter-Domain Routing). |
| Inne typy limitów | Ograniczenia i wytyczne |
|---|---|
| Stan weryfikacji rekordu MX | Domyślny stan weryfikacji rekordu MX to „Fałsz”, co oznacza, że system Google nie sprawdził ostatnio Twojej konfiguracji rekordów MX lub nie skonfigurowano rekordów MX tak, by wskazywały systemy Google. Jeśli rekordy zostały zaktualizowane, ale stan weryfikacji się nie zgadza, może to oznaczać, że rekordy MX nie zostały rozpowszechnione lub w rekordzie występuje literówka. W przypadku rozpowszechniania zalecamy odczekanie czasu zdefiniowanego przez wartość Czas życia danych (TTL) rekordu MX i spróbuj ponownie. |
| Kody krajów | Jeśli nazwa organizacji nie została dostosowana, domyślną nazwą domeny podstawowej jest Twoja domena. Więcej informacji o znakach nazw organizacji znajdziesz w artykule Używanie znaków. |
Właściwość creationTime, liczbowe przedstawienie dat i godzin |
Zobacz ISO 8601 – dane liczbowe dotyczące dat i godzin. |
| Tagi kodowania języka | Zobacz tagi języka RFC 3066 akceptowane w usłudze Google Mail. |
| Nazwa organizacji | Jeśli nazwa organizacji nie została dostosowana, domyślną nazwą domeny podstawowej jest Twoja domena. Więcej informacji o znakach nazw organizacji znajdziesz w artykule Używanie znaków. |