Limity wykorzystania

Limity i kwoty chronią infrastrukturę Google przed zautomatyzowanymi procesami, które wykorzystują interfejs Admin Settings API w niewłaściwy 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 przez niego określonego poziomu jest niezbędne 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 niepowodzenia żądania interfejsu API otrzymasz kod stanu HTTP. Kod stanu 403 zawiera informacje o błędnych danych wejściowych, a kod stanu HTTP 503 zawiera informacje o przekroczeniu limitów interfejsu API. Te odpowiedzi umożliwiają aplikacji niestandardowej wykrywanie tych błędów i podejmowanie odpowiednich działań.

Jeśli Twoje żądania muszą zostać zrealizowane w określonym czasie, wysyłaj je równolegle lub używaj wielu wątków w aplikacji w języku 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 rekomendacja wątku ma swoje wady i nie jest przydatna we wszystkich sytuacjach związanych z interfejsem API. Jeśli liczba żądań będzie zbyt duża, wystąpią błędy związane z limitem.

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 za pomocą algorytmu wykładniczego wycofywania odczekiwał krótką chwilę przed ponowną próbą wykonania nieudanego wywołania. Przykład użycia interfejsu Email Settings API w przypadku jednego wątku polega na odczekaniu 5 sekund i ponowieniu nieudanego wywołania. Jeśli żądanie zostało wykonane, powtórz ten wzorzec w przypadku pozostałych wątków. Jeśli druga prośba nie zostanie zrealizowana, aplikacja powinna zmniejszyć częstotliwość wysyłania próśb, dopóki nie zostanie zrealizowana. Możesz na przykład wydłużyć początkowe 5-sekundowe opóźnienie do 10 sekund i ponownie spróbować wykonać połączenie, które się nie powiodło. Określ 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.

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

Wygeneruj u dostawcy tożsamości zestaw kluczy publicznych i prywatnych za pomocą algorytmu DSA lub RSA. Klucz publiczny jest w formacie certyfikatu X.509. Więcej informacji o kluczach podpisywania logowania jednokrotnego opartego na protokole SAML znajdziesz w artykule Generowanie kluczy i certyfikatów do 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 rozmiar pliku powinien być mniejszy niż 20 KB. Korzystając z niestandardowych logo, pamiętaj, aby przestrzegać Warunków korzystania z usług Google. 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

Wartość ssoWhitelist to adres IP maski sieci w formacie międzydomenowego routingu bez klasy (CIDR).
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 zmiany w rekordzie MX nie zostały rozpowszechnione lub w rekordzie jest błąd. W przypadku propagacji zalecamy odczekać czas określony przez wartość TTL rekordu MX i spróbować ponownie.
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 sekcji Używanie znaków.
creationTime – właściwość, numeryczna reprezentacja dat i godzin.

Zobacz ISO 8601, numeryczne przedstawienie dat i godzin.
Tagi kodowania języka

Zobacz tagi językowe RFC 3066 akceptowane przez Google Mail.
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 sekcji Używanie znaków.

Prośba o zwiększenie limitu dla projektu

W zależności od wykorzystania zasobów w projekcie możesz poprosić o dostosowanie 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 dostosowanie 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 wartości limitów mogą wymagać zwiększenia. Jeśli spodziewasz się znacznego wzrostu wykorzystania, możesz z wyprzedzeniem poprosić o zmianę limitów na stronie Limity w konsoli Google Cloud.

Więcej informacji znajdziesz w tych materiałach: