使用制限

Google Drive API は共有サービスであるため、すべてのユーザーが公平に使用できるように、また Google Workspace システムの全体的なパフォーマンスを保護するために、割り当てと制限が適用されます。

上限は、Google ドライブのリソース使用量を表す抽象的な測定単位である割り当て単位で定義されます。

Drive API の割り当て

次の 3 種類の割り当てが適用されます。

  • プロジェクトごとに 1 分あたり: Google Cloud プロジェクトが 1 分間に使用できる割り当てユニットの数です。

  • プロジェクトごとのユーザーあたりの 1 分あたりの割り当て: これは、クラウド プロジェクトで特定のユーザーが使用できる割り当てユニットの数です。この上限は、ユーザー間で公平に使用量を分配できるようにすることを目的としています。

  • プロジェクトごと、1 日あたり: Google Cloud プロジェクトが 24 時間以内に下り（外向き）できる最大バイト数を定義します。これを超えると料金が適用されます。

次の表に、これらの上限の詳細を示します。

使用量上限の種類 上限
1 プロジェクトあたり毎分 1,000,000 割り当てユニット
1 分、1 ユーザー、1 プロジェクトあたり 325,000 割り当てユニット
1 日あたり、プロジェクトごと 1 TB

割り当てを超えると、403: User rate limit exceeded HTTP ステータス コード レスポンスが返されます。ドライブ バックエンドで追加のレート制限チェックを行うと、429: Rate limit exceeded レスポンスが生成されることもあります。この場合は、指数バックオフ アルゴリズムを使用して、しばらくしてからもう一度お試しください。

1 日の最低配信数

このプロジェクトごとの 1 日あたりの上限は、Google Cloud プロジェクトが 24 時間以内に使用できる割り当てユニットの最大数を定義します。この上限を超えると、料金が適用されます。

このしきい値未満の使用量では追加料金は発生せず、Google Cloud アカウントに請求されることはありません。請求に関する詳細情報は、2026 年後半に、変更が有効になる 90 日以上前にお知らせします。

この 1 日あたりのしきい値の上限の引き上げをリクエストすることはできません。

次の表に、上限の詳細を示します。

しきい値の上限の種類 上限
1 日あたり、プロジェクトごと 400,000,000 割り当てユニット

詳細については、エージェント ツールと API の Google Workspace 標準モデルをご覧ください。

メソッドごとの割り当てユニットの費用

リクエストごとに消費される割り当てユニットの数は、次の表に示すように、呼び出されるメソッドによって異なります。

読み取りメソッド（5 割り当てユニット）

メソッド
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

List メソッド（100 割り当てユニット）

メソッド
drive.accessproposals.list
drive.apps.list
drive.changes.list、drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list、drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

編集メソッド（50 割り当てユニット）

メソッド
drive.approvals.decline
drive.children.delete、drive.children.insert
drive.comments.create、drive.comments.delete、drive.comments.insert、drive.comments.patch、drive.comments.update
drive.drives.create、drive.drives.delete、drive.drives.hide、drive.drives.insert、drive.drives.unhide、drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete、drive.parents.insert
drive.permissions.create、drive.permissions.delete、drive.permissions.insert、drive.permissions.patch、drive.permissions.update
drive.properties.delete、drive.properties.insert、drive.properties.patch、drive.properties.update
drive.replies.create、drive.replies.delete、drive.replies.insert、drive.replies.patch、drive.replies.update
drive.revisions.delete、drive.revisions.patch、drive.revisions.update
drive.teamdrives.create、drive.teamdrives.delete、drive.teamdrives.insert、drive.teamdrives.update

ダウンロード メソッド（200 割り当てユニット）

メソッド
drive.files.download、drive.files.export、drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

その他のメソッド（5 割り当てユニット）

メソッド
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken、drive.files.generateIds、drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

追加の制約

Drive API を使用する場合は、次の制約が適用されます。

  • Google Workspace ユーザーがマイドライブとすべての共有ドライブ間でアップロードできるのは、1 日あたり 750 GB のみです。この上限はコピーにも適用されます。

  • 750 GB の上限に達したユーザー、または 750 GB を超えるファイルをアップロードしたユーザーは、24 時間が経過するまで、追加のファイルをアップロードまたはコピーできません。

  • ユーザーがアップロードできるファイルの最大サイズは 5 TB です。上限を超えてアップロードできるのは、上限を超えた最初のファイルのみです。ユーザーがコピーできる最大ファイルサイズは 750 GB です。

  • 通知チャンネルを開くときに指定したアドレスに配信される通知は、割り当て制限にカウントされません。ただし、changes.watch、channels.stop、files.watch メソッドの呼び出しは割り当てにカウントされます。

  • 1 分あたりの割り当ての範囲内であれば、1 日に送信できるリクエスト数に上限はありません。

  • Google Workspace アカウントの種類によっては、ドライブ ストレージの上限が追加されることがあります。

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

時間ベースのエラー（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 時間に達した後も再試行を続けることができます。この時点より後の再試行では、バックオフ時間を増加させ続ける必要はありません。たとえば、クライアントが maximum_backoff 時間に 64 秒を使用している場合、この値に達すると、クライアントは 64 秒ごとに再試行できます。いずれかの時点で、クライアントが無限に再試行を行わないようにする必要があります。

適切な再試行間の待ち時間と再試行回数は、ユースケースとネットワークの状態により異なります。

料金

Google Drive API の標準的な使用はすべて、追加料金なしでご利用いただけます。割り当てリクエストの上限を超えると、2026 年後半に Google Cloud 請求先アカウントに料金が発生する予定です。詳細については、エージェント ツールと API の Google Workspace 標準化モデルをご覧ください。

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

プロジェクトのリソース使用量に応じて、割り当ての調整をリクエストできます。サービス アカウントによる API 呼び出しは、単一のアカウントを使用していると見なされます。割り当ての調整を申請しても、必ずしも承認されるとは限りません。割り当て値を大幅に増やす割り当て調整リクエストは、承認に時間がかかることがあります。

割り当て量はすべてのプロジェクトで同じとは限りません。Google Cloud の使用量が多くなるに伴い、割り当て値を引き上げる必要が生じる場合があります。使用量の大幅な増加が見込まれる場合は、事前に Google Cloud コンソールの [割り当てとシステム上限] ページから割り当ての調整をリクエストできます。

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

ドライブ MCP サーバーの割り当て

Drive MCP サーバーは、クエリ費用割り当て指標を使用します。次の表に、各 Drive MCP サーバー メソッドのクエリ費用をセクションごとに示します。

ドライブ MCP の割り当て

適用される割り当てには次の 2 種類があります。

  • プロジェクトごとに 1 分あたり: これは、Google Cloud プロジェクトに対する 1 分あたりのクエリ費用です。

  • 1 分、1 ユーザー、1 プロジェクトあたり: これは、特定のユーザーが 1 分間に使用できる Google Cloud プロジェクトのクエリ費用です。

次の表に、これらの割り当ての詳細を示します。

使用量上限の種類 上限
1 プロジェクトあたり毎分 325,000
1 分、1 ユーザー、1 プロジェクトあたり 1,000,000

ドライブ MCP ツールセットの割り当て

次の表に、各 drivemcp.googleapis.com ツールセットのクエリ費用を示します。

エンドポイント ツール クエリの費用

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

詳細については、Drive MCP API リファレンスをご覧ください。