Groups Migration API: 한도 및 할당량

한도 및 할당량은 부적절한 방식으로 Groups Migration API를 사용하는 자동화된 프로세스로부터 Google 인프라를 보호합니다. API의 과도한 요청은 무해한 오타로 인해 발생하거나 불필요한 API 호출을 하는 비효율적으로 설계된 시스템으로 인해 발생할 수 있습니다. 원인에 관계없이 특정 소스의 트래픽이 일정 수준에 도달하면 Google Workspace 시스템의 전반적인 상태를 위해 해당 소스의 트래픽을 차단해야 합니다.

API 요청 실패

드물지만 API 요청이 실패하면 애플리케이션이 HTTP 상태 코드 응답을 수신합니다. 403의 HTTP 상태 코드에는 잘못된 입력에 대한 오류 정보가 있고 HTTP 상태 코드 503에는 어느 API 할당량이 초과되었는지를 나타내는 오류 정보가 있습니다. 이러한 응답을 통해 커스텀 애플리케이션이 이러한 오류를 감지하고 적절한 조치를 취할 수 있습니다.

긴급한 요청

정해진 기간 내에 요청을 완료해야 하는 경우 요청을 동시에 보내거나 자바 또는 C# 애플리케이션에서 여러 스레드를 사용하세요. 예를 들어 월별 또는 다른 기간별로 요청을 나눌 수 있습니다. 스레드의 경우 요청당 하나의 스레드인 10개의 스레드로 시작해 보세요. 스레드 권장사항에는 장단점이 있으며 모든 API 상황에 유용하지는 않습니다. 요청 수가 너무 커지면 할당량 오류가 발생합니다.

시간 기반 오류

시간 기반 오류 (스레드당 X초 동안 최대 N개), 특히 503 상태 코드 오류인 모든 오류의 경우 코드에서 예외를 포착하고 지수 백오프 알고리즘을 사용하여 실패한 호출을 다시 시도하기 전에 약간의 지연을 기다리는 것이 좋습니다. 한 스레드의 Groups Migration API 예는 5초 동안 대기한 후 실패한 호출을 재시도하는 것입니다. 요청이 성공하면 다른 스레드에 이 패턴을 반복합니다. 두 번째 요청이 실패하면 애플리케이션은 호출이 성공할 때까지 요청 빈도에 따라 다시 축소되어야 합니다. 예를 들어 처음 5초 지연 시간을 10초로 늘리고 실패한 호출을 다시 시도합니다. 재시도 한도도 결정합니다. 예를 들어, 애플리케이션이 사용자에게 오류를 반환하기 전에 지연 시간을 다르게 하여 요청을 5~7회 다시 시도합니다.

한도

API 한도 카테고리 한도
초당 쿼리 수(QPS) 개발자 프로젝트 한도는 계정당 초당 쿼리 수 (QPS) 10개입니다.

할당량

API 할당량 카테고리 할당량
일일 최대 API 요청 수 일일 최대 API 요청은 500,000회입니다.
메일 보관처리, 만료 그룹 자료실은 만료되지 않습니다. 메일은 그룹이 삭제될 때까지 자료실에 보관됩니다. 이메일 보관 정책은 그룹 자료실의 메시지에 영향을 주지 않습니다.
메일 메시지 크기 메일 메시지의 최대 크기는 25MB입니다. 이 한도에는 메일의 메타데이터 헤더, 본문, 첨부파일이 포함됩니다.

기타 한도 유형

기타 한도 제한사항 및 가이드라인
콘텐츠 유형 형식 이메일 메시지는 표준 RFC 822 텍스트 형식이어야 합니다. 이전된 이메일을 업로드할 때 요청의 콘텐츠 유형은 Content-type: message/rfc822 헤더를 사용해야 합니다.
API 응답의 데이터 형식 응답의 데이터 형식은 JavaScript Object Notation(JSON)입니다.
데이터 위치 정책 Groups Migration API는 계약상의 이유로 특정 지리적 또는 정치적 경계에 데이터를 저장해야 하는 데이터 위치 정책을 지원하지 않습니다. 계정에 데이터 위치가 필요한 경우 Groups Migration API를 사용하지 마세요.
동시 메시지 삽입 Groups Migration API는 다른 그룹 자료실에 이메일을 삽입하는 동시 요청을 지원합니다. 하지만 Groups Migration API는 동일한 그룹 자료실로의 동시 메시지 삽입을 지원하지 않습니다. 이 버전의 Groups Migration API에서는 일괄 요청이 지원되지 않습니다.
승인되지 않은 요청 Groups Migration API는 승인되지 않은 요청을 수락하지 않습니다. 승인 토큰이 제공되지 않으면 요청이 승인되지 않은 것으로 간주됩니다. 자세한 내용은 인증 및 승인 자세히 알아보기를 참고하세요.