한도와 할당량을 통해 자동화된 프로세스로부터 Google 인프라를 보호합니다. 그룹스 설정 API를 부적절한 방식으로 사용합니다. API의 과도한 요청은 무해한 오타 또는 불필요한 API 호출을 발생시키는 비효율적으로 설계된 시스템일 수 있습니다. 원인과 상관없이 특정 소스의 트래픽이 일정 수준에 도달할 때 트래픽을 차단하면 여러 가지 방법을 제공합니다.
API 요청 실패
드물지만 API 요청이 실패하면 애플리케이션이 HTTP 상태 코드를 수신합니다.
있습니다. HTTP 상태 코드 403에 어떤 API 할당량을 나타내는 오류 정보가 있나요?
한도를 초과했습니다. 응답을 통해 커스텀 애플리케이션이 오류를 감지하고 적절한 조치를 취할 수 있습니다.
있습니다.
시간에 민감한 요청
정해진 기간 내에 요청을 완료해야 하는 경우 요청을 동시에 전송하세요. Java 또는 C# 애플리케이션에서 여러 스레드를 사용할 수 있습니다. 예를 들어 요청을 월별 또는 확인할 수 있습니다. 스레드의 경우 요청당 하나의 스레드가 있는 스레드 10개로 시작해 보세요. 스레드 권장사항에는 장단점이 있으므로 모든 API 상황에 유용하지는 않습니다. 만약 할당량 오류가 발생합니다
시간 기반 오류
시간 기반의 모든 오류 (스레드당 X초 동안 최대 N개)의 경우 특히
503 상태 코드 오류가 발생하면 코드에서 예외를 포착하고 다음을 사용하여
-
지수 백오프
실패한 호출을 다시 시도하기 전에 약간의 지연을 기다립니다. 그룹스 설정 API 예제:
한 스레드는 5초를 기다렸다가 실패한 호출을 재시도하는 것입니다. 요청이 성공하면 다음 작업을 반복합니다.
패턴을 찾습니다. 두 번째 요청이 실패하면 애플리케이션은
호출이 성공할 때까지 요청 빈도를 줄입니다. 예를 들어
5초에서 10초까지 지연된 후 실패한 통화를 다시 시도합니다. 재시도 결정
있습니다. 예를 들어 애플리케이션 실행 전에 지연 시간을 달리하여 5~7회 요청을 재시도합니다.
사용자에게 오류를 반환합니다.
할당량
| API 할당량 카테고리 | 할당량 |
|---|---|
| 일별 쿼리 수 | 일일 최대 100,000개의 쿼리를 만들 수 있습니다. 다음 이상의 용량이 필요한 경우 이 한도를 초과하는 경우 Google Cloud 콘솔의 할당량 페이지 |
| 그룹 설명, 최대 크기 | 그룹 설명은 4,096자(영문 기준)까지 입력할 수 있습니다. |
| 그룹 이름, 최대 크기 | 그룹 이름은 최대 60자(영문 기준)까지 입력할 수 있습니다. |
defaultMessageDenyNotificationText |
알림 텍스트는 최대 10,000자(영문 기준)까지 가능합니다. 자세히 알아보려면
defaultMessageDenyNotificationText 속성에 대한 자세한 내용은
API 참조
|
maxMessageBytes |
기본 최대 메일 크기는 1MB입니다. maxMessageBytes에 대해 자세히 알아보기
속성에 대한 자세한 내용은 API 참조를 확인하세요.
|
한도
| 한도 유형 | 제한사항 및 가이드라인 |
|---|---|
| 데이터 형식, 기본값 |
기본 데이터 형식은 JSON입니다. 이 API는 Atom 형식도 지원합니다. JSON과 Atom 모두 데이터 형식은 전체 읽기-쓰기 기능을 지원합니다. 자세한 내용은 JSON 및 Atom 데이터 형식. |
| 그룹스 설정 API, 사용 설정 | 그룹스 설정 API를 호출하기 전에 Directory API를 사용 설정해야 합니다. 자세한 내용은 자세한 내용은 Google Workspace API 사용 설정을 참고하세요. |