한도와 할당량은 이메일 감사 API를 부적절한 방식으로 사용하는 자동화된 프로세스로부터 Google 인프라를 보호합니다. API의 과도한 요청은 무해한 오타로 인해 발생하거나 불필요하게 API를 호출하는 비효율적으로 설계된 시스템에서 발생할 수 있습니다. 원인에 관계없이 특정 소스 트래픽이 특정 수준에 도달할 때 발생하는 트래픽을 차단하면 Google Workspace 시스템의 전반적인 상태가 개선되어야 합니다. 한도는 한 개발자의 작업이 대규모 커뮤니티에 부정적인 영향을 미치지 않도록 하는 데 도움이 됩니다.
드물지만 API 요청에 실패하면 HTTP 상태 코드 응답을 받게 됩니다. 403의 상태 코드에는 잘못된 입력에 대한 오류 정보가 있고 503의 HTTP 상태 코드에 초과된 API 할당량을 나타내는 오류 정보가 포함되어 있습니다. 이러한 응답을 통해 커스텀 애플리케이션에서 이러한 오류를 감지하고 적절한 조치를 취할 수 있습니다.
정해진 기간 내에 요청을 완료해야 하는 경우 요청을 병렬로 보내거나 자바 또는 C# 애플리케이션의 여러 스레드를 사용하세요. 병렬 요청의 예로는 한 사용자의 많은 이메일을 동시에 추가하거나 삭제하는 대신 여러 사용자에게 소량의 이메일을 일괄적으로 요청하는 경우가 있습니다. 스레드의 경우 사용자 이메일당 하나의 스레드인 10개의 스레드로 시작해 봅니다. 스레드 추천에는 장단점이 있으며 모든 API 상황에서 유용한 것은 아닙니다. 요청 수가 너무 많으면 할당량 오류가 발생합니다. 또 다른 균형 예시를 들자면 전체 메시지 업로드 속도에 대한 이메일 감사 API 할당량이 있습니다. 업로드 속도는 업로드를 요청하는 스레드 수에 관계없이 사용자별로 초당 1개의 API 요청입니다.
시간 기반의 모든 오류 (스레드당 N초 동안 최대 N개), 특히 503 상태 코드 오류의 경우 코드에서 예외를 포착하고 지수 백오프 알고리즘을 사용하여 잠시 기다린 후에 실패한 호출을 다시 시도하는 것이 좋습니다. 한 스레드에 대한 Email Audit API 예시는 5초 동안 기다렸다가 실패한 호출을 다시 시도하는 것입니다. 요청이 성공하면 다른 스레드에 이 패턴을 반복합니다. 두 번째 요청이 성공하지 않을 경우 애플리케이션은 호출이 성공할 때까지 요청 빈도를 줄여 축소해야 합니다.
예를 들어 초기 5초 지연 시간을 10초로 늘리고 실패한 통화를 다시 시도합니다. 또한 재시도 한도를 결정합니다. 예를 들어 애플리케이션이 사용자에게 오류를 반환하기 전에 지연 시간을 서로 다르게 하여 5~7회 요청을 다시 시도합니다.
다음 표에는 Email Audit API의 한도가 나와 있습니다.
| API 한도 카테고리 | 한도 |
|---|---|
| 암호화된 편지함 파일, 생성 | 암호화된 편지함 파일 생성에 따라 시스템에서 준비에 최대 며칠이 걸릴 수 있습니다. |
| 암호화된 편지함 파일, 삭제 오류 | 암호화된 편지함을 삭제할 때 오류가 발생하면 요청에 MARKED_DELETE 상태가 지정됩니다. 이러한 요약 및 내보내기 파일은 24시간 이내에 Google에서 자동으로 다시 삭제합니다(남은 파일 포함). MARKED_DELETE의 상태가 일관되게 반환되면 지수 백오프 전략을 사용해 보세요.
|
다음 표에는 Email Audit API의 할당량이 나와 있습니다.
| API 할당량 카테고리 | 할당량 |
|---|---|
| ClientLogin 인증 토큰 | 24시간 동안 유효합니다. 오류는 401 token expired입니다.
|
| 날짜 형식 | 이메일 감사 API와 함께 사용하기 전에 모든 날짜를 협정 세계시 (UTC) 형식으로 변환하세요. 자세한 내용은 UTC 변환기를 참조하세요. |
암호화된 편지함 파일, EXPIRED 요약 및 내보내기 파일
|
Google은 암호화된 편지함 파일을 3주 동안 보관합니다. 30일 후에는 삭제됩니다. 이 기간 내에 도메인 편지함을 다운로드할 책임은 도메인 관리자에게 있습니다. |
| 암호화된 편지함 파일, 형식 | 암호화된 편지함 파일은 mbox 형식입니다. |
| 암호화된 편지함 파일, 최대 생성 요청 수 | 일일 최대 편지함 내보내기 생성 요청은 도메인의 모든 관리자가 보낸 총 요청 100개입니다. |
| 암호화된 편지함 파일 상태, 페이지로 나누기 | 모든 편지함 요청의 상태를 요청하면 응답에서 대량의 데이터를 반환할 수 있습니다. Email Audit API는 최대 100개의 항목이 포함된 페이지 및 다음 결과 페이지를 가리키는 link rel='next' 태그의 URI가 있는 페이지로 이 데이터를 일괄 처리합니다. 클라이언트 애플리케이션을 개발할 때 코드에서 이러한 추가 결과를 관리해야 합니다.
|
| 이메일 모니터링 | 일일 최대 이메일 모니터링 요청 수는 1,500개입니다. 이 한도는 도메인에 적용되며 하루 동안 관리자가 수행한 모든 요청이 포함됩니다. |
| 공개 키 | Email Audit API는 하나의 키만 지원합니다.
공개 키는 GNU Privacy Guard (GPG) 소프트웨어를 사용합니다. PGP 형식이며 ASCII로 인코딩된 RSA 암호화 키입니다. 공개 키를 업로드하기 전에 먼저 base64로 인코딩된 문자열로 변환해야 합니다. 공개 키 파일은 문자 집합 US-ASCII(ASCII용 IANA 기본 문자 집합 이름)를 사용하여 읽어야 합니다. |
| 검색 중 | searchQuery 및 includeDeleted 매개변수는 함께 사용할 수 없습니다. includeDeleted="true"인 경우 검색어를 사용할 수 없습니다.
|