할당량 및 한도

채널 서비스 한도

아래 표에는 채널 서비스에 적용되는 여러 가지 한도가 나와 있습니다.

리소스 한도

리소스 한도
계정 리셀러 도메인당 1개
고객 무제한
자격 무제한
채널 파트너 링크 무제한

Google Workspace 한도

리소스 한도
최대 좌석 수 50,000(상향은 지원팀에 문의)
최대 체험판 기간 30일(해당 SKU의 경우)

테스트 채널 서비스 콘솔별 한도

리소스 한도
최대 좌석 수 10
최대 체험판 기간 1일

테스트 채널 서비스 콘솔을 사용할 때 추가로 고려해야 할 사항이 있습니다.

  • 고객은 테스트 도메인 이름 지정 규칙을 따라야 합니다.
  • Google Workspace 사용 권한은 생성 후 3일이 지나면 삭제 대상으로 표시되고 매주 삭제됩니다.

Cloud Channel API 비율 한도

API 비율 한도를 사용하면 Cloud Channel API에 전송할 수 있는 요청 수를 정의할 수 있습니다. 한도는 프로젝트 단위로 존재하며 잘못된 요청을 포함한 모든 API 요청에는 할당량 비용이 발생합니다.

비율 제한은 60초 간격으로 적용됩니다. 60초 내에 한도에 도달하면 추가 요청을 수행하기 위해 할당량이 새로고침될 때까지 기다려야 합니다.

기본 할당량은 60초당 120개 요청이며, 일부 요청의 경우 비용이 더 높습니다.

API 메서드 요청 비용
accounts.customers.entitlements.list 5
accounts.customers.list 5
다른 모든 엔드포인트 1

예를 들어 60초 이상이고 기본 할당량이 120개인 경우 다음을 수행할 수 있습니다.

  • accounts.customers.entitlements.list에 대한 호출 10개(총 비용: 50)
  • accounts.customers.customers.list에 대한 호출 10개(총 비용: 50)
  • 다른 엔드포인트에 대한 호출 20개(총 비용: 20)

API 요청에 더 높은 비율 제한이 필요하다면 Google Cloud Console을 통해 상향 조정을 요청할 수 있습니다.

권장사항

다음은 Cloud Channel API의 API 비율 제한을 사용하는 데 도움이 되는 몇 가지 권장사항입니다.

  • 클라이언트 측 비율 제한을 사용하여 인위적인 비율 제한을 설정합니다. 이렇게 하면 한 클라이언트가 모든 할당량을 사용하지 못하게 할 수 있습니다.

  • 지수 백오프를 사용하여 할당량 도달 후 요청 간격을 점진적으로 늘립니다. 이렇게 하면 서버가 버킷을 다시 채울 수 있는 시간이 생깁니다.

  • operations.get 호출 시 작업을 반환하는 모든 메서드에 대해 설명된 폴링 권장사항을 따르세요.

  • 메시지 rateLimitExceeded와 함께 403 오류가 발생하면 몇 초 후 요청을 다시 시도해 보세요. 할당량은 60초마다 다시 채워지므로 다음 새로고침을 대기한 후에는 요청이 성공적으로 실행됩니다.