사용 제한

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

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

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

프로젝트에 적용된 한도보다 더 많은 요청을 해야 하는 경우 다음 안내를 따르세요.

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

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

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