사용 제한

할당량은 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. 할당량 관련 설정을 확인하고 변경하려면 할당량을 선택합니다. 사용량 통계를 확인하려면 사용량을 선택합니다.