한도와 할당량은 리셀러 API를 부적절하게 사용하는 자동 프로세스로부터 Google 인프라를 보호합니다. 과도한 요청은 철자 오류나 비효율적인 시스템 설계로 인해 발생할 수 있습니다. Google Workspace 시스템의 정상 상태를 유지하기 위해 Google은 특정 소스의 트래픽이 일정 수준에 도달하면 트래픽을 차단합니다. 이렇게 하면 한 개발자의 행위가 커뮤니티에 부정적인 영향을 미치지 않습니다.
API 요청 실패
API 요청이 실패하면 애플리케이션에서 HTTP 상태 코드를 수신합니다. 403 상태 코드는 입력이 잘못되었음을 나타내고 503 상태 코드는 API 할당량이 초과되었음을 나타냅니다. 이러한 응답을 사용하여 오류를 감지하고 조치를 취하세요.
시간 기반 오류
시간 기반 오류, 특히 503 상태 코드의 경우 지수 백오프 알고리즘을 사용합니다. 실패한 호출을 다시 시도하기 전에 약간의 지연 시간을 기다립니다. 예를 들어 5초 동안 기다렸다가 다시 시도합니다. 성공하면 다른 스레드에 대해 패턴을 반복합니다. 두 번째 요청이 실패하면 호출이 성공할 때까지 요청 빈도를 줄입니다. 재시도 횟수를 5~7회로 결정하는 것도 좋습니다.
한도
| API 한도 카테고리 | 한도 |
|---|---|
구독 purchaseOrderId |
이 속성은 최대 80개의 일반 텍스트 문자를 허용합니다. |
구독 maxResults |
maxResults 쿼리 문자열은 1~100개의 결과일 수 있습니다.
기본값은 결과 20개입니다.
|
전송 토큰 (customerAuthToken) |
고객의 이전 토큰은 생성 후 30일 동안 유효합니다. |
| 고객의 최대 사용자 수 | 계약에 따라 최대 사용자 수는 50,000명 또는 리셀러 계약에 정의된 최대 사용자 수입니다. |
| 승인되지 않은 요청 | Google에서는 리셀러 API에 대한 승인되지 않은 요청을 허용하지 않습니다. 인증 토큰이 제공되지 않으면 요청이 승인되지 않습니다. 자세한 내용은 인증 및 승인 알아보기를 참고하세요. |
기타 유형의 한도
| 기타 유형의 한도 | 제한사항 및 가이드라인 |
|---|---|
| 데이터 형식 |
데이터 형식은 JavaScript 객체 표기법(JSON)입니다.
JSON은 임의의 데이터 구조를 나타내는 일반적인 인터넷 형식입니다. C, C++, C#, Java, JavaScript, Perl, Python 등 C 계열 언어 프로그래머에게 익숙한 규칙을 사용하는 언어 독립적인 텍스트 형식입니다. |
| 시간 형식 | 날짜와 시간은 밀리초 단위의 에포크 변환기를 사용합니다. 이 형식은 정기 결제 생성 시간, 요금제 약정 시작 및 종료 시간, 무료 체험 종료 시간에 적용됩니다. |