使用制限

割り当ては 60 秒の移動平均でチェックされるため、使用量の急増に対応できます。デフォルトでは、Classroom API には次の表の制限が適用されます。

上限 Quota Standard
クライアントごとの 1 日あたりのクエリ数 4,000,000（平均 46 QPS）
クライアントあたりの 1 分あたりのクエリ数 3,000（50 QPS）
1 ユーザー、1 分あたりのクエリ数 1,200（20 QPS）

許可される QPS は、さまざまな運用上の要因に応じて増減することがあります。

プロジェクトに適用されている上限を超えるリクエストを行う必要がある場合:

  1. まず、再試行可能なエラー（リクエストが上限を超えたときに返される RESOURCE_EXHAUSTED エラーなど）に対して、リクエストを再試行することで対応します。できれば、指数バックオフを使用します。
  2. この機能が提供されているエンドポイントで変更をポーリングしている場合は、代わりにプッシュ通知の使用を検討してください。
  3. プロジェクトに割り当てられた上限を超えるリクエストを送信する必要がある場合は、上限の引き上げをリクエストする手順について、以下をご覧ください。

プロジェクトの使用量上限を確認して変更する手順、または割り当ての増加をリクエストする手順は次のとおりです。

  1. プロジェクトの請求先アカウントをまだ持っていない場合は、1 つ作成します。
  2. API Console で API ライブラリの [有効な API] ページに移動し、リストから API を選択します。
  3. 割り当て関連の設定を表示および変更するには、[割り当て] を選択します。使用統計情報を表示するには、[使用量] を選択します。