Mail Admin Quarantine API는 격리된 메일을 검색하고 가져오는 Google Workspace 인프라를 보호하기 위해 각 Google Cloud 프로젝트에 분당 사용량 할당량을 적용합니다. 할당량은 메서드가 수행하는 작업 유형별로 그룹화됩니다.
할당량
다음 표에는 할당량이 나와 있습니다. 각 할당량은 Cloud 프로젝트당 분당이며, 프로젝트가 모든 Google Workspace 고객 및 가장된 관리자에 대해 수행하는 모든 요청을 계산합니다.
각 API 호출은 페이지 크기 또는 일괄 메서드의 경우 일괄의 메시지 수와 관계없이 하나의 요청으로 계산됩니다. 예를 들어 메시지가 500개인 batchRelease 요청은 쓰기 요청을 하나 사용합니다.
Google Cloud 콘솔의 API 및 서비스 > 사용 설정된 API 및 서비스 > Admin Quarantine API > 할당량 및 시스템 한도에서 프로젝트의 현재 할당량 사용량을 확인할 수 있습니다.
요청 제약조건
| 제약조건 | 값 |
|---|---|
list 및 search 요청의 최대 pageSize |
메시지 300개 |
batchRelease 또는 batchDeny 요청당 최대 메시지 수 |
메일 500개 |
| 검색 및 목록 창 | 지난 30일 동안 수신된 메시지 |
할당량 오류 해결
프로젝트가 할당량을 초과하면 API는 RESOURCE_EXHAUSTED 상태와 함께 HTTP 429 오류를 반환합니다.
{
"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"
}
}
할당량을 초과하지 않으려면 다음 안내를 따르세요.
- 지수 백오프로 다시 시도합니다.
429오류가 발생하면 다시 시도하기 전에 기다리고 시도가 실패할 때마다 대기 시간을 늘립니다. 자세한 내용은 지수 백오프를 참조하세요. - 유용한 최대 페이지 크기를 사용합니다. 검색 및 목록 요청의 할당량이 가장 적습니다. 작은 페이지를 여러 개 요청하는 대신 페이지당 최대 300개의 메시지를 요청합니다.
- 필터를 사용합니다. 필요한 메시지만 검색하도록
filter또는query를 사용하여search요청을 좁힙니다. - 일괄 작업에 배치 메서드를 사용합니다. 단일
batchRelease또는batchDeny요청은release또는deny호출당 메시지 하나와 비교하여 최대 500개의 메시지를 해제하거나 거부할 수 있습니다. - 작업을 가끔 폴링합니다. 일괄 작업을 기다릴 때는
customers.operations리소스의get메서드를 계속 호출하지 말고 몇 초마다 호출하세요. - 증분 동기화. 실행할 때마다 전체 스팸 격리 저장소를 다시 나열하는 대신
status = PENDING_TRIAGE를 필터링하고 새 메일만 처리합니다.
개발자 프리뷰 중에는 할당량을 늘릴 수 없습니다. 사용 사례에 더 높은 할당량이 필요한 경우 Google Workspace 개발자 프리뷰 프로그램을 통해 의견을 공유하세요.