Limity pozwalają zabezpieczyć infrastrukturę Google przed automatycznym procesem, który używa niestosownego interfejsu Email Audit API. Zbyt wiele żądań z interfejsu API może być wynikiem 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 limitom działania deweloperów nie wpływają negatywnie na społeczność.
W rzadkich przypadkach, gdy żądanie interfejsu API się nie powiedzie, otrzymasz odpowiedź z kodem stanu HTTP. Kod stanu 403 zawiera informacje o błędzie dotyczące nieprawidłowych danych wejściowych, a kod stanu HTTP 503 zawiera informacje o błędzie, które wskazują limity interfejsu API. Dzięki tym odpowiedziom Twoja aplikacja niestandardowa może wykrywać te błędy i podejmować 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#. Przykładem żądania równoległego może być wysyłanie próśb o niewielką grupę e-maili od różnych użytkowników zamiast jednoczesnego dodawania i usuwania wielu e-maili od jednego użytkownika. W przypadku wątków spróbuj rozpocząć od 10 wątków, po 1 na wątek na użytkownika. 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ń stanie się zbyt duża, wystąpią błędy limitu. Innym przykładem jest zapewnienie maksymalnej przepustowości przesyłania wiadomości za pomocą interfejsu Email Audit API. Szybkość przesyłania to 1 żądanie API – na sekundę – na użytkownika, bez względu na to, ile wątków przesyła żądania.
W przypadku wszystkich błędów czasowych (maksymalnie N elementów przez N sekund na wątek), zwłaszcza kodu błędu 503, zalecamy wychwycenie tego wyjątku, a także za pomocą algorytmu wykładniczego ponowienia, zanim uruchomisz ponownie nieudane żądanie. W przypadku jednego wątku przykładowy interfejs API do kontroli poczty e-mail to odczekanie 5 sekund i ponowne wykonanie nieudanego wywołania. Jeśli żądanie jest udane, 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. Przykład: spróbuj ponownie wysłać żądanie 5–7 razy z innym czasem, po którym aplikacja zwróci błąd użytkownikowi.
W tabeli poniżej znajdziesz limity interfejsu Email Audit API:
| Kategorie limitów w interfejsie API | Limity |
|---|---|
| Zaszyfrowane pliki skrzynki pocztowej, tworzenie | Tworzenie zaszyfrowanych plików skrzynki pocztowej może zająć systemowi do kilku dni (w zależności od rozmiaru). |
| Zaszyfrowane pliki skrzynki pocztowej, błędy przy usuwaniu | Gdy usunięto zaszyfrowaną skrzynkę pocztową i wystąpi błąd, żądanie otrzymuje stan MARKED_DELETE. Podsumowania i pliki eksportu są automatycznie ponownie usuwane przez Google w ciągu 24 godzin (z pozostałymi plikami). Jeśli stan MARKED_DELETE jest stale zwracany, spróbuj wykonać strategię wykładnicznego odczekania.
|
Tabela poniżej zawiera limity dotyczące interfejsu Email Audit API:
| Kategorie limitów interfejsu API | Limity |
|---|---|
| Tokeny uwierzytelniania ClientLogin | Ważny przez 24 godziny. Błąd: 401 token expired.
|
| Formaty daty | Przekonwertuj wszystkie daty na format UTC (Coordinated Universal TIme) przed użyciem ich w połączeniu z interfejsem Email Audit API, aby dowiedzieć się więcej na temat konwertera UTC. |
Zaszyfrowane pliki skrzynki pocztowej, EXPIRED podsumowania i pliki eksportu
|
Google przechowuje zaszyfrowane pliki skrzynki pocztowej przez 3 tygodnie. Po tym czasie są one usuwane. Za ten okres odpowiada administrator domeny za pobranie tych plików skrzynki pocztowej. |
| Zaszyfrowane pliki skrzynki pocztowej, format | Pliki zaszyfrowanych skrzynek pocztowych są w formacie mbox. |
| Zaszyfrowane pliki skrzynki pocztowej, maksymalna liczba żądań utworzenia | Maksymalna dzienna liczba próśb o utworzenie eksportu skrzynki pocztowej to łącznie 100 żądań od wszystkich administratorów w domenie. |
| Stan zaszyfrowanego pliku skrzynki pocztowej, podział na strony | Gdy żądasz stanu wszystkich żądań skrzynki pocztowej, odpowiedzi mogą zwracać duże ilości danych. Interfejs Email Audit API grupuje te dane w strony, które zawierają maksymalnie 100 wpisów, oraz identyfikator URI w tagu link rel='next' wskazującym następną stronę wyników. Podczas tworzenia aplikacji klienckiej kod musi zarządzać tymi dodatkowymi wynikami.
|
| Monitorowanie poczty e-mail | Maksymalna dzienna liczba żądań monitorowania poczty e-mail to 1500. Ten limit dotyczy domeny i obejmuje wszystkie żądania zgłoszone przez administratorów w ciągu dnia. |
| Klucz publiczny | Interfejs Email Audit API obsługuje tylko 1 klucz.
Klucz publiczny wykorzystuje oprogramowanie GNU Privacy Guard (GPG). Jest w formacie PGP i jest zaszyfrowanym kluczem szyfru RSA RSA. Przed przesłaniem klucza publicznego musisz przekonwertować go na ciąg znaków zakodowany w base64. Plik klucza publicznego powinien być odczytany za pomocą zestawu znaków US-ASCII (preferowana nazwa zestawu znaków IANA dla ASCII). |
| Szukam | Parametry searchQuery i includeDeleted wzajemnie się wykluczają. Zapytanie nie jest możliwe, jeśli includeDeleted="true".
|