使用制限

Google Drive API は共有サービスであるため、Google は割り当てと制限を すべてのユーザーが公平に使用できるようにし、全体的なパフォーマンスを Google Workspace システムの 基本原則について説明しました

Notifications は、 通知チャンネルを開いても、割り当て上限にカウントされません。ただし、 changes.watch の呼び出し channels.stopfiles.watch メソッドのカウント対象 できます。

割り当てを超えた場合は、403: User rate limit exceeded を受け取ります。 HTTP ステータス コード レスポンス。次のインスタンスに対するレート制限のチェックが ドライブのバックエンドで 429: Too many requests が生成されることもあります。 レスポンスが返されます。このような場合は、指数バックオフを使用して アルゴリズムを参照し、しばらくしてからもう一度お試しください。ただし、 以下のとおり、1 分あたりの割り当て数に制限はありません。 (1 日あたり)

次の表に、クエリの上限を示します。

割り当て
クエリ
60 秒あたり 12,000
1 ユーザーあたり 60 秒あたり 12,000

時間ベースの割り当てエラーを解決する

すべての時間ベースのエラー(X 分あたり最大 N 個のリクエスト)に対しては、 コードが例外を捕捉し、切り捨て型指数バックオフを使用して、 過剰な負荷が発生しないようにすることができます。

指数バックオフは、ネットワーク アプリケーションの標準的なエラー処理方法です。「 指数バックオフ アルゴリズムにより、待機時間が指数関数的に増加してリクエストを再試行 最大バックオフ時間まで再試行可能です。それでもリクエストが失敗する場合は、 リクエストが成功するまで、リクエスト間の遅延が時間の経過とともに増加することに注意してください。

アルゴリズムの例

指数バックオフ アルゴリズムはリクエストを指数関数的に再試行するため、待ち時間が長くなる 最大バックオフ時間内に再試行します。例:

  1. Google Drive API にリクエストを送信します。
  2. リクエストが失敗した場合、1 + random_number_milliseconds 待ってから再試行する 表示されます。
  3. リクエストが失敗した場合は、2 + random_number_milliseconds 待ってから再試行する 表示されます。
  4. リクエストが失敗した場合は、4 + random_number_milliseconds 待ってから再試行する 表示されます。
  5. このようにして、最大 maximum_backoff 時間まで繰り返します。
  6. 再試行の最大回数まで待機と再試行を続けるが、待機は増加しない 間隔を空けておけます

ここで

  • 待ち時間は min(((2^n)+random_number_milliseconds), maximum_backoff)です。 n は、反復(リクエスト)のたびに 1 ずつ増加します。
  • random_number_milliseconds は、ミリ秒以下の乱数です。 1,000 になります。これにより、複数のクライアントが同期される事態を回避でき、 同時に再試行して、同期された状態でリクエストを送信し、 あります。random_number_milliseconds の値は、 リクエストを再試行します。
  • 通常、maximum_backoff は 32 秒または 64 秒です。適切な値 ユースケースによって異なります

クライアントは、maximum_backoff 時間に達した後も再試行を続行できます。 この時点より後の再試行では、バックオフ時間を増加させ続ける必要はありません。対象 たとえば、クライアントが 64 秒の maximum_backoff 時間を使用している場合、 この値を指定すると、クライアントは 64 秒ごとに再試行できます。ある時点で 無期限に再試行しないようにする必要があります。

再試行までの待ち時間と再試行回数はユースケースによって異なる ネットワーク状態を確認できます。

料金

Google Drive API はすべて追加料金なしでご利用いただけます。割り当ての超過 リクエストの上限によって追加料金は発生せず、アカウントへの請求は行われません。

割り当ての増加をリクエストする

プロジェクトのリソース使用量に応じて、割り当てをリクエストする必要があります。 増加します。サービス アカウントによる API 呼び出しは、 できます。割り当ての増加を申請しても、承認が保証されるわけではありません。大 割り当ての増加が承認されるまで時間がかかることがあります。

割り当て量はすべてのプロジェクトで同じとは限りません。ますます Google Cloud を使用する傾向にあるため、 割り当ての増加が必要になる場合があります今後のイベントで 使用量が増加した場合は、事前に 割り当ての調整をリクエストする [割り当て] ページで 確認できます。

詳細については、次のリソースをご覧ください。