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