한도와 할당량은 관리 설정 API를 부적절한 방식으로 사용하는 자동 프로세스로부터 Google 인프라를 보호합니다. API의 과도한 요청은 무해한 오타로 인해 발생할 수도 있고, 불필요한 API 호출을 하는 비효율적으로 설계된 시스템으로 인해 발생할 수도 있습니다. 원인과 무관하게 Google Workspace 시스템을 전반적으로 정상 상태로 유지하려면 특정 소스의 트래픽이 일정 수준에 도달할 때 트래픽을 차단해야 합니다. 이를 통해 한 개발자의 행위가 더 큰 커뮤니티에 부정적인 영향을 미치지 않도록 할 수 있습니다.
API 요청이 실패할 경우 HTTP 상태 코드 응답이 표시됩니다. 상태 코드 403에는 잘못된 입력에 관한 오류 정보가 있고 HTTP 상태 코드 503에는 초과된 API 할당량을 나타내는 오류 정보가 있습니다. 이러한 응답을 통해 맞춤 애플리케이션이 이러한 오류를 감지하고 적절한 조치를 취할 수 있습니다.
요청을 정해진 시간 내에 완료해야 하는 경우 요청을 병렬로 전송하거나 Java 또는 C# 애플리케이션에서 여러 스레드를 사용하세요. 예를 들어 월별 또는 다른 기간별로 요청을 분류합니다. 스레드의 경우 요청당 하나의 스레드인 10개의 스레드로 시작해 보세요. 스레드 추천에는 장단점이 있으며 모든 API 상황에 유용한 것은 아닙니다. 요청 수가 너무 많아지면 할당량 오류가 발생합니다.
시간 기반 오류 (스레드당 X초 동안 최대 N개)의 경우, 특히 503 상태 코드 오류의 경우 코드가 예외를 포착하고 지수 백오프 알고리즘을 사용하여 실패한 호출을 재시도하기 전에 약간의 지연 시간을 기다리는 것이 좋습니다. 한 스레드의 이메일 설정 API 예는 5초 동안 기다린 후 실패한 호출을 재시도하는 것입니다. 요청이 성공하면 다른 스레드에 대해 이 패턴을 반복합니다. 두 번째 요청이 성공하지 않으면 호출이 성공할 때까지 애플리케이션에서 요청 빈도를 줄여야 합니다. 예를 들어 초기 5초 지연 시간을 10초로 늘리고 실패한 호출을 다시 시도합니다. 또한 재시도 한도를 결정합니다. 예를 들어 애플리케이션이 사용자에게 오류를 반환하기 전에 지연 시간을 다르게 하여 요청을 5~7회 재시도합니다.
| API 할당량 카테고리 | 할당량 |
|---|---|
| ClientLogin 인증 토큰 | 24시간 동안 유효합니다. 오류는 '401 토큰 만료됨'입니다. |
| 공개 키 및 비공개 키 생성 |
ID 제공업체와 함께 DSA 또는 RSA 알고리즘을 사용하여 공개 및 비공개 키 집합을 생성합니다. 공개 키는 X.509 형식의 인증서에 있습니다. SAML 기반 싱글 사인온 서명 키에 대한 자세한 내용은 Google Workspace 싱글 사인온 서비스용 키 및 인증서 생성을 참고하세요. |
| 로고 |
계정의 로고 이미지 파일은 JPEG, PNG 또는 GIF 형식일 수 있습니다. 권장 크기는 143x59픽셀이며 파일은 20KB보다 작아야 합니다. 맞춤 로고를 사용할 때는 Google 서비스 약관을 준수해야 합니다. Google 로고, Gmail 로고 또는 기타 Google 로고는 사용하지 마세요. 자세한 내용은 로고 및 방문 페이지 정책을 참고하세요. |
| ssoWhitelist |
ssoWhitelist는 클래스 없는 도메인 간 라우팅(CIDR) 형식의 네트워크 마스크 IP 주소입니다. |
| 기타 유형의 한도 | 제한사항 및 가이드라인 |
|---|---|
| MX 레코드 확인 상태 |
기본 MX 레코드 확인 상태는 `false` 입니다. 이는 Google 시스템에서 최근에 MX 레코드 구성을 확인하지 않았거나 MX 레코드가 Google 시스템을 가리키도록 구성되지 않았음을 의미합니다. 레코드를 업데이트했는데 확인 상태가 false로 유지되면 MX 레코드 업데이트가 전파되지 않았거나 레코드에 오타가 있을 수 있습니다. 전파의 경우 MX 레코드의 TTL (수명) 값에 정의된 시간만큼 기다렸다가 다시 시도하는 것이 좋습니다. |
| 국가 코드 |
조직 이름을 맞춤설정하지 않은 경우 기본값은 기본 도메인 이름입니다. 조직 이름 문자에 대한 자세한 내용은 문자 사용을 참고하세요. |
creationTime 속성, 날짜 및 시간의 숫자 표현 |
ISO 8601, 날짜 및 시간의 숫자 표현을 참고하세요. |
| 언어 인코딩 태그 |
Google 메일에서 허용되는 RFC 3066 언어 태그를 참고하세요. |
| 조직 이름 |
조직 이름을 맞춤설정하지 않은 경우 기본값은 기본 도메인 이름입니다. 조직 이름 문자에 대한 자세한 내용은 문자 사용을 참고하세요. |
프로젝트별 할당량 상향 요청
프로젝트의 리소스 사용량에 따라 할당량 조정을 요청할 수 있습니다. 서비스 계정의 API 호출은 단일 계정을 사용하는 것으로 간주됩니다. 조정된 할당량을 신청해도 승인된다고 보장할 수 없습니다. 할당량 값을 크게 늘리는 할당량 조정 요청은 승인에 시간이 더 오래 걸릴 수 있습니다.
모든 프로젝트의 할당량이 동일하지는 않습니다. 시간이 지남에 따라 Google Cloud 사용량이 늘어나면 할당량 값을 늘려야 할 수 있습니다. 앞으로 사용량이 현저하게 늘어날 것으로 예상되는 경우 Google Cloud 콘솔의 할당량 페이지에서 사전에 할당량 조정을 요청할 수 있습니다.
자세한 내용은 다음 리소스를 참고하세요.