Limity wykorzystania

Limity chronią infrastrukturę Google przed zautomatyzowanymi procesami, które wykorzystują interfejs Admin Settings API w nieodpowiedni sposób. Nadmierna liczba żądań z interfejsu API może być spowodowana nieszkodliwą literówką lub nieefektywnie zaprojektowanym systemem, 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 konieczne dla ogólnej kondycji systemu Google Workspace. Dzięki temu działania jednego dewelopera nie mogą negatywnie wpłynąć na większą społeczność.

W mało prawdopodobnym przypadku nieudanego żądania do interfejsu API otrzymasz kod stanu HTTP. Kod stanu 403 zawiera informacje o błędach związanych z nieprawidłowym wejściem, a kod stanu HTTP 503 zawiera informacje o błędach wskazujące, które limity interfejsu API zostały przekroczone. Te odpowiedzi umożliwiają aplikacji niestandardowej wykrywanie tych błędów i podejmowanie odpowiednich działań.

Jeśli żądania muszą zostać zrealizowane w określonym czasie, wysyłaj je równolegle lub używaj wielu wątków w aplikacji Java lub C#. Na przykład podziel żądania według miesiąca lub innego okresu. W przypadku wątków zacznij od 10 wątków, po jednym na żądanie. Pamiętaj, że zalecenie dotyczące wątków ma wady i nie jest przydatne we wszystkich sytuacjach związanych z interfejsem API. Jeśli liczba żądań będzie zbyt duża, wystąpią błędy limitu.

W przypadku wszystkich błędów związanych z czasem (maksymalnie N elementów przez X sekund na wątek), zwłaszcza błędów z kodem stanu 503, zalecamy, aby kod przechwytywał wyjątek i, używając algorytmu wzrastającego czasu do ponowienia , czekał przez krótki czas przed ponowieniem nieudanego wywołania. Przykładem użycia interfejsu Email Settings API w jednym wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie się powiedzie, powtórz ten wzorzec w przypadku pozostałych wątków. Jeśli drugie żądanie się nie powiedzie, aplikacja powinna zmniejszyć częstotliwość żądań, aż do momentu, gdy wywołanie się powiedzie. Na przykład zwiększ początkowe opóźnienie 5 sekund do 10 sekund i ponownie spróbuj wykonać nieudane wywołanie. Określ też limit ponowień. Na przykład ponów żądanie 5–7 razy z różnymi czasami opóźnienia, zanim aplikacja zwróci użytkownikowi błąd.

Kategorie limitów interfejsu API Limity
Tokeny uwierzytelniania ClientLogin Ważne przez 24 godziny. Błąd to „401 token expired”.
Generowanie kluczy publicznych i prywatnych

U dostawcy tożsamości wygeneruj zestaw kluczy publicznych i prywatnych kluczy przy użyciu algorytmu DSA lub RSA. Klucz publiczny jest w certyfikacie w formacie X.509 formatted. Więcej informacji o kluczach podpisywania logowania jednokrotnego opartego na SAML znajdziesz w artykule Generowanie kluczy i certyfikatów na potrzeby usługi logowania jednokrotnego Google Workspace.
Logo

Plik graficzny z logo konta może być w formacie JPEG, PNG lub GIF. Zalecany rozmiar to 143 × 59 pikseli, a plik powinien być mniejszy niż 20 KB. Używając niestandardowych logo, pamiętaj, aby przestrzegać Warunków korzystania z usług Google Terms of Service. Nie używaj logo Google, logo Gmaila ani żadnych innych logo Google. Więcej informacji znajdziesz w zasadach dotyczących logo i strony docelowej.
ssoWhitelist

ssoWhitelist to maska sieciowa adresu IP w formacie CIDR(Classless Inter-Domain Routing ).
Inne rodzaje limitów Ograniczenia i wytyczne
Stan weryfikacji rekordu MX

Domyślny stan weryfikacji rekordu MX to `false`, co oznacza, że system Google nie sprawdzał ostatnio konfiguracji rekordu MX lub rekordy MX nie zostały skonfigurowane tak, aby wskazywały systemy Google. Jeśli rekordy zostały zaktualizowane, a stan weryfikacji nadal jest fałszywy, może to oznaczać, że aktualizacje rekordu MX nie zostały rozpowszechnione lub w rekordzie jest literówka. Aby rozpowszechnić rekord, zalecamy odczekanie czasu określonego przez wartość TTL (Time To Live) rekordu MX i ponowienie próby.
Kody krajów

Jeśli nazwa organizacji nie została dostosowana, domyślnie jest to nazwa domeny podstawowej. Informacje o znakach w nazwie organizacji znajdziesz w artykule Użycie znaków.
Właściwość creationTime, numeryczna reprezentacja daty i godziny

Zobacz ISO 8601, numeryczna reprezentacja daty i godziny.
Tagi kodowania języka

Zobacz tagi języka RFC 3066 akceptowane przez Gmaila.
Nazwa organizacji

Jeśli nazwa organizacji nie została dostosowana, domyślnie jest to nazwa domeny podstawowej. Informacje o znakach w nazwie organizacji znajdziesz w artykule Użycie znaków.

Wysyłanie prośby o zwiększenie limitu na projekt

W zależności od wykorzystania zasobów w projekcie możesz poprosić o zmianę limitu. Wywołania interfejsu API przez konto usługi są traktowane jako korzystanie z jednego konta. Wysłanie wniosku o zmianę limitu nie gwarantuje jego zatwierdzenia. Zatwierdzenie próśb o zmianę limitu , które znacznie zwiększają jego wartość, może potrwać dłużej.

Nie wszystkie projekty mają takie same limity. W miarę upływu czasu i zwiększania wykorzystania Google Cloud może być konieczne zwiększenie limitów. Jeśli przewidujesz znaczny wzrost wykorzystania, możesz aktywnie poprosić o zmianę limitów na stronie Limity w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach: