Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

用量限制

Google Drive API 是共用服務，因此我們設有配額和限制，確保所有使用者都能公平使用，並保護 Google Workspace 系統的整體效能。

限制是以配額單位定義，這是代表 Google 雲端硬碟資源用量的抽象測量單位。

Drive API 配額

系統會強制執行三種配額：

每分鐘/每項專案：這是 Google Cloud 專案在一分鐘內可使用的配額單位數量。
每項專案每位使用者每分鐘：這是任何一位使用者在雲端專案中可使用的配額單位數量。這項限制旨在確保使用者能公平分配用量。
每項專案每日：這項定義是指 Google Cloud 專案在 24 小時內可輸出的最大位元組數，超過這個數量就會產生費用。

下表詳細列出這些限制：

用量限制類型	限制
每項專案每分鐘	1,000,000 個配額單位
每項專案每位使用者每分鐘	325,000 個配額單位
每項專案每天	1 TB

如果超出配額，您會收到 403: User rate limit exceeded HTTP 狀態碼回應。雲端硬碟後端上的其他頻率限制檢查也可能產生 429: Rate limit exceeded 回應。如果發生這種情況，請使用指數輪詢演算法，稍後再試。

每日結算最低曝光次數門檻

這項「每日每項專案」限制，定義了 Google Cloud 專案在 24 小時內可使用的配額單位上限，超過上限就會產生費用。

用量低於這個門檻不會產生額外費用，您的 Google Cloud 帳戶也不會產生費用。我們會在 2026 年稍晚提供完整的帳單詳細資料，並在任何異動生效前至少 90 天通知您。

您無法要求提高這項每日門檻上限。

下表詳細列出限制：

門檻限制類型	限制
每項專案每天	400,000,000 個配額單位

詳情請參閱「Google Workspace 標準化模型：代理工具和 API」。

各方法配額單位費用

每項要求耗用的配額單位數量，取決於呼叫的方法，如下表所示：

讀取方法 (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 使用者每天只能在「我的雲端硬碟」和所有共用雲端硬碟之間上傳 750 GB 的檔案，這項限制也適用於副本。
如果使用者達到 750 GB 的上限，或上傳超過 750 GB 的檔案，則必須等待 24 小時，才能上傳或複製其他檔案。
使用者可上傳的檔案大小上限為 5 TB，只有第一個超出上限的檔案會完成上傳作業。使用者可複製的檔案大小上限為 750 GB。
通知傳送至開啟通知管道時指定的位址，不會計入配額限制。不過，呼叫 changes.watch、channels.stop 和 files.watch 方法會計入配額。
只要不超過每分鐘配額，每天可提出的要求數量就沒有限制。
視您的 Google Workspace 帳戶類型而定，可能會有額外的雲端硬碟儲存空間限制。

解決時間配額錯誤

對於所有時間型錯誤 (每 X 分鐘最多 N 個要求)，建議您的程式碼擷取例外狀況，並使用截斷指數輪詢，確保裝置不會產生過多負載。

指數輪詢是網路應用程式的標準錯誤處理策略。指數輪詢演算法會重試要求，並以指數方式增加要求之間的等待時間，直到達到最大輪詢時間。如果要求仍未成功，請務必逐漸增加要求之間的延遲時間，直到要求成功為止。

演算法範例

指數輪詢演算法會以指數方式重試要求，並增加重試之間的等待時間，直到達到最大輪詢時間。例如：

向 Google Drive API 提出要求。
如果要求失敗，請等待 1 + random_number_milliseconds，然後重試要求。
如果要求失敗，請等待 2 + random_number_milliseconds 秒，然後重試要求。
如果要求失敗，請等待 4 + random_number_milliseconds 秒，然後重試要求。
依此類推，時間上限為 maximum_backoff。
繼續等待及重試，直到重試次數達特定上限，但不要增加重試之間的等待時間。

其中：

等待時間為 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 帳單帳戶將產生費用。詳情請參閱「Google Workspace 標準化模型：代理工具和 API」。

申請提高配額

視專案的資源用量而定，您可能需要要求調整配額。服務帳戶發出的 API 呼叫會視為使用單一帳戶。我們不保證一定能核准您提出的配額調整要求。如果配額調整要求會大幅提高配額值，可能需要較長時間才能獲得核准。

並非所有專案的配額都相同。隨著 Google Cloud 用量增加，您可能需要提高配額。如果您預期使用量將大幅攀升，可以透過 Google Cloud 控制台的「配額與系統限制」頁面，主動提出配額調整要求。

如要進一步瞭解相關內容，請參閱下列資源：

雲端硬碟 MCP 伺服器配額

雲端硬碟 MCP 伺服器會使用查詢成本分配指標。下表依各部分詳細列出每個 Drive MCP 伺服器方法的查詢費用：

雲端硬碟 MCP 配額

系統會強制執行兩種配額：

每分鐘每項雲端專案：這是 Google Cloud 雲端專案一分鐘的查詢費用。
每位使用者每項專案每分鐘：這是 Google Cloud 專案一分鐘內，任何一位使用者可使用的查詢費用。

下表詳細列出這些配額：

用量限制類型	限制
每項專案每分鐘	325,000
每項專案每位使用者每分鐘	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 參考資料。

用量限制 透過集合功能整理內容 你可以依據偏好儲存及分類內容。