Limity wykorzystania interfejsu Mail Admin Quarantine API

Interfejs Mail Admin Quarantine API wymusza limity wykorzystania na minutę w przypadku każdego projektu w chmurze Google Cloud, aby chronić infrastrukturę Google Workspace, która wyszukuje i pobiera wiadomości poddane kwarantannie. Limity są grupowane według typu pracy wykonywanej przez metodę.

Limity

W tabeli poniżej znajdziesz limity. Każdy limit jest określany na minutę na projekt w chmurze i obejmuje wszystkie żądania wysyłane przez projekt w przypadku wszystkich klientów Google Workspace i administratorów, pod których się podszywa.

Limit Wartość Metody
Żądania wyszukiwania i wyświetlania listy 60 żądań na minutę customers.quarantinedMessages.list, customers.quarantinedMessages.search
Żądania odczytu 1200 żądań na minutę customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Żądania zapisu 300 żądań na minutę customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Każde wywołanie interfejsu API liczy się jako jedno żądanie, niezależnie od rozmiaru strony lub, w przypadku metod wsadowych, liczby wiadomości we wsadzie. Na przykład żądanie batchRelease z 500 wiadomościami zużywa jedno żądanie zapisu.

Bieżące wykorzystanie limitu przez projekt możesz sprawdzić w konsoli Google Cloud w sekcji Interfejsy API i usługi > Włączone interfejsy API i usługi > Admin Quarantine API > Limity przydziału i limity systemu.

Ograniczenia żądań

Ograniczenie Wartość
Maksymalnie pageSize w przypadku żądań list i search 300 wiadomości,
Maksymalna liczba wiadomości na żądanie batchRelease lub batchDeny 500 wiadomości,
Okno wyszukiwania i listy Wiadomości otrzymane w ciągu ostatnich 30 dni

Rozwiązywanie błędów związanych z limitami

Gdy projekt przekroczy limit, interfejs API zwraca błąd HTTP 429 ze stanem RESOURCE_EXHAUSTED:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

Aby nie przekroczyć limitów:

  • Podejmij ponowne próby ze wzrastającym czasem do ponowienia. Jeśli pojawi się błąd 429, poczekaj, zanim spróbujesz ponownie, i wydłużaj czas oczekiwania po każdej nieudanej próbie. Więcej informacji znajdziesz w artykule o wzrastającym czasie do ponowienia.
  • Używaj największego przydatnego rozmiaru strony. Żądania wyszukiwania i wyświetlania listy mają najmniejszy limit. Zamiast wielu małych stron poproś o maksymalnie 300 wiadomości na stronę.
  • Używaj filtrów. Zawęź żądania search za pomocą filter lub query, aby pobierać tylko potrzebne wiadomości.
  • Używaj metod zbiorczych do wykonywania działań zbiorczych. Pojedyncze żądanie batchRelease lub batchDeny może zwolnić lub odrzucić do 500 wiadomości, podczas gdy wywołanie release lub deny może dotyczyć tylko jednej wiadomości.
  • Ograniczaj odpytywanie o operacje. Gdy czekasz na operację zbiorczą, wywołuj metodę get zasobu customers.operations co kilka sekund, a nie w sposób ciągły.
  • Synchronizuj przyrostowo. Zamiast wyświetlać całą kwarantannę przy każdym uruchomieniu, filtruj według status = PENDING_TRIAGE i przetwarzaj tylko nowe wiadomości.

W wersji przedpremierowej dla programistów nie można zwiększyć limitu. Jeśli Twój przypadek użycia wymaga wyższych limitów, prześlij opinię w ramach programu wersji przedpremierowej dla programistów Google Workspace.