API 使用の上限設定

API に応じて、1 日あたりのリクエスト数1 分あたりのリクエスト数ユーザーごとの 1 分あたりのリクエスト数などを制限することで、リクエストの上限を明示的に設定できます。

上限を設定することで、課金対象の使用量を制限できます。たとえば、無料の使用上限を超えて課金されるのを防ぐため、1 日の上限のリクエストを設定できます。

リクエスト数の上限を表示および変更する

請求可能な API に対するすべてのリクエストに制限を設定できます。ほとんどの API ではデフォルトの制限が設定されていますが、Google が指定する最大値までその制限を変更できます。一部の API では、プロジェクトで課金を有効にするまで、低い値が設定されています。

API の制限を表示または変更する手順は次のとおりです。

  1. Google Cloud コンソールで、[API とサービスのダッシュボード] ページに移動します。

    [API とサービス] の [ダッシュボード] に移動

  2. プロジェクト リストからプロジェクトを選択するか、新しいプロジェクトを作成します。
  3. 対象の API の名前をクリックします。
  4. [割り当て] をクリックします。タブナビに [割り当て] タブが表示されていないことは、選択した API で割り当てが定義されていないことを意味します。
  5. 上限となる割り当てを見つけるには、[フィルタ] フィールドに適切なプロパティと値を入力します。たとえば、サブネットワークの割り当てを見つけるには、「Quota:Subnetworks」と入力します。
  6. 上限とする割り当ての横にあるチェックボックスをクリックしてから、[ 割り当てを編集] をクリックします。
  7. 割り当て変更フォームに、設定する新しい上限を記入します。
  8. [リクエストを送信] をクリックします。

一部の API では、フォームを提出することによって、制限を上げるようにリクエストできます。一部の API では、プロジェクトで課金が有効になっている場合にのみ、割り当てを増やすことができます。

プレミアム プランの割り当てセクションは Google マップ プレミアム プランに関連していますが、これはもう提供されていません。現在 Google マップ プレミアム プランをご利用でない場合は、これらのセクションは編集しないでください。

ユーザーごとのリクエスト数の制限

個々のユーザーが API 割り当てを使い切ることを防ぐために、一部の API では、ユーザーごとの 1 分あたりの上限がデフォルトで設定されています。

API に 1 分あたりのユーザーごとのデフォルトの上限値が含まれているかどうかを確認するには、リクエスト数の上限を参照および変更するの手順に沿って API の割り当てを確認します。その API にこのようなデフォルトの上限が存在する場合は、その値を変更して、以下の手順を行い、各ユーザーが使用できる割り当てを制限できます。API の割り当てにこのデフォルトの上限がない場合、その上限の追加や変更はサポートされません。

個々のユーザーは一意の文字列で識別されます。個々のユーザーは一意の文字列で識別されます。ユーザーに代わって要求を行うサーバー側アプリケーション(呼び出し側のコードが、所有しているサーバー上でホストされている場所)を作成する場合は、利用を制限している API へのリクエストに quotaUser パラメータを含める必要があります。このパラメータは、システム パラメータのドキュメントで定義されています。

ユーザーを識別するには、quotaUser=userID URL クエリ パラメータを使用します。この値は短期の割り当ての適用のみに使用されるため、実際のユーザー ID を使用する必要はありません。ユーザーを一意に識別する 40 文字以内の任意の文字列を選択できます。

quotaUser パラメータは、ユーザーごとの 1 分あたりのリクエスト数を制限するためだけ使用されます。quotaUser パラメータを送信しないと、すべての呼び出しがサーバーマシンに帰属します。この場合、呼び出しはユーザーによって制限されません。

API に 1 分あたりのユーザーごとのデフォルトの上限値が含まれていない場合、quotaUser 値は無視されます。

プロジェクト内の API のすべての割り当てを表示および編集する

特定のプロジェクト内の課金可能なすべての API について、Google Cloud コンソールで IAM と管理者セクションの割り当てページを表示して、割り当て制限の確認、編集、制限の緩和をリクエストできます。

プロジェクト内のすべての課金可能 API の割り当てを表示したり編集したりするには、次の手順を実行します。

  1. Google Cloud コンソールで、[割り当て] ページに移動します。

    Quotas に移動

  2. プロジェクト リストからプロジェクトを選択するか、新しいプロジェクトを作成します。 選択したプロジェクトの [割り当て] ページが開き、各サービスで使用できる割り当ての種類ごとに 1 行の項目を含むリストが表示されます。
  3. [表をフィルタリング] をクリックして、特定のプロパティで割り当てをクエリします。
  4. 編集する割り当ての横にあるチェックボックスをオンにします。一部のチェックボックスをオンにするには、プロジェクトで課金を有効にする必要があります。
  5. [割り当てを編集] をクリックします。
  6. 表示された [割り当ての変更] ペインで、サービスビューを展開し、必要に応じてそのサービスの割り当てを編集して、[完了] をクリックします。
  7. 選択した各サービスで同じ手順を繰り返して割り当てを編集します。
    • 入力ボックスには、現在の割り当て上限が事前に入力されています。
    • 送信時にアラート アイコン()が表示されるサービスには、入力エラーがあります。
    • 割り当ては、前述の通りに選択することで、それを編集して追加できます。
    • [割り当ての変更] ペインで、展開されていないサービスビューにカーソルを合わせて削除アイコン()をクリックすると、サービスを削除できます。
  8. 割り当ての編集が完了したら、[次へ] をクリックします。
  9. 割り当ての編集リクエストを確認する必要がある場合は、[連絡先の詳細情報] フォームが表示されます。連絡先の詳細情報をフォームに記入します。
  10. [リクエストを送信] をクリックします。