사용 제한

할당량은 사용량이 급증할 수 있으므로 60초 이동 평균으로 확인됩니다. 기본적으로 Classroom API의 한도는 다음 표에 나와 있습니다.

한도 할당량 표준
클라이언트별 일일 쿼리 수 4,000,000 (평균 46 QPS)
클라이언트별 분당 쿼리 수 3,000 (50 QPS)
사용자당 분당 쿼리 수 1,200 (20 QPS)

허용되는 QPS는 여러 운영 요소에 따라 증가하거나 감소할 수 있습니다.

프로젝트에 적용된 한도보다 더 많은 요청을 해야 하는 경우:

  1. 먼저 재시도 가능한 오류 (예: 요청이 한도를 초과할 때 반환되는 RESOURCE_EXHAUSTED 오류)에 대응하려면 지수 백오프를 사용하는 것이 좋습니다.
  2. 이 기능이 제공되는 엔드포인트의 변경사항을 폴링하는 경우 대신 푸시 알림을 사용하는 것이 좋습니다.
  3. 여전히 프로젝트에 할당된 한도보다 더 많은 요청을 해야 하는 경우 아래에서 한도 상향을 요청하는 방법을 확인하세요.

프로젝트의 사용량 한도를 확인 또는 변경하거나 할당량 증가를 요청하려면 다음 단계를 따르세요.

  1. 프로젝트의 결제 계정이 아직 없는 경우 계정을 만듭니다.
  2. API 콘솔에서 API 라이브러리의 사용 설정된 API 페이지를 방문하여 목록에서 API를 선택합니다.
  3. 할당량 관련 설정을 확인하고 변경하려면 할당량을 선택합니다. 사용량 통계를 확인하려면 사용량을 선택합니다.