Limity i kwoty chronią infrastrukturę Google przed zautomatyzowanymi procesami, które wykorzystują interfejs Email Audit API w nieodpowiedni sposób. Nadmierna liczba żądań z interfejsu API może być wynikiem nieszkodliwego błędu w pisowni lub nieefektywnie zaprojektowanego systemu, 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 nie określonego poziomu jest niezbędne dla ogólnej kondycji systemu Google Workspace. Limity pomagają zapewnić, że działania jednego dewelopera nie będą miały negatywnego wpływu 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łędach związanych z nieprawidłowymi danymi wejściowymi, 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 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#. Przykładem żądań równoległych jest wysyłanie próśb o małe partie e-maili od różnych użytkowników zamiast dodawania lub usuwania wielu e-maili od jednego użytkownika jednocześnie. W przypadku wątków zacznij od 10 wątków, po jednym na adres e-mail użytkownika. Pamiętaj, że zalecenie dotyczące wątku ma swoje wady i nie jest przydatne we wszystkich sytuacjach związanych z interfejsem API. Jeśli liczba żądań jest zbyt duża, pojawiają się błędy związane z limitami. Innym przykładem kompromisu jest limit interfejsu Email Audit API dotyczący maksymalnej ogólnej szybkości przesyłania wiadomości. Szybkość przesyłania to 1 żądanie do interfejsu API na sekundę na użytkownika, niezależnie od liczby wątków wysyłających żądania przesyłania.
W przypadku wszystkich błędów związanych z czasem (maksymalnie N elementów na N sekund na wątek), zwłaszcza błędów kodu stanu 503, zalecamy, aby kod przechwytywał wyjątek i za pomocą algorytmu wykładniczego wycofywania czekał na niewielkie opóźnienie przed ponowną próbą wykonania nieudanego wywołania. Przykładem użycia interfejsu Email Audit API w przypadku jednego wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie zostanie zrealizowane, powtórz tę czynność w przypadku pozostałych wątków. Jeśli drugie żądanie nie zostanie zrealizowane, aplikacja powinna zmniejszyć częstotliwość żądań, dopóki nie zostanie zrealizowane. Na przykład zwiększ początkowe 5-sekundowe opóźnienie do 10 sekund i ponownie spróbuj nawiązać połączenie, które się nie powiodło. Określ też limit ponownych prób. Na przykład ponów żądanie 5–7 razy z różnymi czasami opóźnienia, zanim aplikacja zwróci użytkownikowi błąd.
W tej tabeli znajdziesz limity interfejsu Email Audit API:
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Tworzenie zaszyfrowanych plików skrzynki pocztowej |
Utworzenie zaszyfrowanych plików skrzynki pocztowej może zająć systemowi kilka dni w zależności od rozmiaru. |
| Zaszyfrowane pliki skrzynki pocztowej, błędy podczas usuwania |
Gdy usuwasz zaszyfrowaną skrzynkę pocztową i wystąpią błędy, żądanie otrzymuje stan |
W tej tabeli znajdziesz limity interfejsu Email Audit API:
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Tokeny uwierzytelniania ClientLogin |
Ważny przez 24 godziny. Błąd to |
| Formaty daty |
Przed użyciem dat w interfejsie Email Audit API przekonwertuj je na format uniwersalnego czasu koordynowanego (UTC). Więcej informacji znajdziesz w konwerterze UTC. |
|
zaszyfrowane pliki skrzynki pocztowej, |
Google przechowuje zaszyfrowane pliki skrzynki pocztowej przez 3 tygodnie. Po tym czasie są one usuwane. Pobranie tych plików skrzynki pocztowej w tym czasie jest obowiązkiem administratora domeny. |
| Zaszyfrowane pliki skrzynki pocztowej, format |
Zaszyfrowane pliki skrzynek pocztowych mają format mbox. |
| Zaszyfrowane pliki skrzynki pocztowej, maksymalna liczba żądań utworzenia |
Maksymalna liczba próśb o utworzenie eksportu skrzynki pocztowej dziennie to łącznie 100 próśb od wszystkich administratorów w domenie. |
| Stan zaszyfrowanego pliku skrzynki pocztowej, podział na strony |
Gdy wysyłasz żądanie stanu wszystkich próśb dotyczących skrzynek pocztowych, odpowiedzi mogą zwracać duże ilości danych. Interfejs Email Audit API dzieli te dane na strony, z których każda zawiera maksymalnie 100 pozycji, a identyfikator URI w tagu |
| Monitor poczty e-mail |
Maksymalna liczba żądań monitorowania e-maili dziennie to 1500. Ten limit dotyczy domeny i obejmuje wszystkie żądania wysłane przez dowolnego administratora w ciągu dnia. |
| Klucz publiczny |
Interfejs Email Audit API obsługuje tylko 1 klucz. Klucz publiczny korzysta z oprogramowania GNU Privacy Guard (GPG). Jest to klucz szyfrowania RSA zakodowany w formacie PGP i ASCII. Przed przesłaniem klucza publicznego musisz najpierw przekonwertować go na ciąg zakodowany w formacie base64. Plik klucza publicznego powinien być odczytywany z zestawem znaków US-ASCII (IANA to preferowana nazwa zestawu znaków ASCII). |
| Szukam |
Parametry |