Hạn mức sử dụng

Vì API Google Drive là một dịch vụ dùng chung, nên chúng tôi áp dụng hạn mức và giới hạn để đảm bảo tất cả người dùng đều sử dụng dịch vụ này một cách công bằng và để bảo vệ hiệu suất tổng thể của hệ thống Google Workspace.

Giới hạn được xác định theo đơn vị hạn mức, một đơn vị đo lường trừu tượng thể hiện mức sử dụng tài nguyên của Google Drive.

Hạn mức API Drive

Có 3 loại hạn mức được áp dụng:

  • Mỗi phút cho mỗi dự án: Đây là số đơn vị hạn mức mà dự án Google Cloud của bạn có thể sử dụng trong một phút.

  • Mỗi phút trên mỗi người dùng trên mỗi dự án: Đây là số đơn vị hạn mức mà một người dùng cụ thể có thể sử dụng trong dự án trên đám mây của bạn. Hạn mức này nhằm giúp bạn đảm bảo việc phân bổ mức sử dụng một cách công bằng cho người dùng.

  • Mỗi ngày cho mỗi dự án: Chỉ số này xác định số byte tối đa mà dự án trên đám mây Google Cloud của bạn có thể gửi đi trong khoảng thời gian 24 giờ trước khi bị tính phí.

Bảng sau đây trình bày chi tiết các giới hạn này:

Loại hạn mức sử dụng Hạn mức
Mỗi phút mỗi dự án 1.000.000 đơn vị hạn mức
Mỗi phút cho mỗi người dùng trên mỗi dự án 325.000 đơn vị hạn mức
Mỗi ngày mỗi dự án 1 TB

Nếu vượt quá hạn mức, bạn sẽ nhận được phản hồi mã trạng thái HTTP 403: User rate limit exceeded. Các bước kiểm tra giới hạn tốc độ bổ sung trên phần phụ trợ của Drive cũng có thể tạo ra phản hồi 429: Rate limit exceeded. Nếu gặp trường hợp này, bạn nên sử dụng thuật toán thời gian đợi luỹ thừa rồi thử lại sau.

Ngưỡng thanh toán hằng ngày

Hạn mức mỗi ngày cho mỗi dự án này xác định số lượng đơn vị hạn mức tối đa mà dự án trên đám mây của bạn trên Google Cloud có thể sử dụng trong khoảng thời gian 24 giờ trước khi bị tính phí.

Mức sử dụng dưới ngưỡng này sẽ không phát sinh thêm phí và tài khoản Google Cloud của bạn sẽ không bị tính phí. Thông tin đầy đủ về việc thanh toán sẽ được chia sẻ vào cuối năm 2026, ít nhất 90 ngày trước khi mọi thay đổi có hiệu lực.

Bạn không thể yêu cầu tăng ngưỡng giới hạn hằng ngày này.

Bảng sau đây trình bày chi tiết về hạn mức:

Loại ngưỡng giới hạn Hạn mức
Mỗi ngày mỗi dự án 400.000.000 đơn vị hạn mức

Để biết thêm thông tin, hãy xem bài viết Mô hình chuẩn hoá của Google Workspace cho các công cụ và API của tác nhân.

Chi phí đơn vị hạn mức theo phương thức

Số đơn vị hạn mức được sử dụng cho mỗi yêu cầu sẽ khác nhau tuỳ thuộc vào phương thức được gọi, như mô tả trong các bảng sau:

Phương thức đọc (5 đơn vị hạn mức)

Phương thức
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

Phương thức danh sách (100 đơn vị hạn mức)

Phương thức
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

Phương thức chỉnh sửa (50 đơn vị hạn mức)

Phương thức
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

Phương thức tải xuống (200 đơn vị hạn mức)

Phương thức
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Các phương thức khác (5 đơn vị hạn mức)

Phương thức
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Ràng buộc bổ sung

Các quy tắc ràng buộc sau đây được thực thi khi làm việc với API Drive:

  • Người dùng Google Workspace chỉ có thể tải 750 GB lên mỗi ngày giữa Drive của tôi và tất cả bộ nhớ dùng chung; giới hạn này cũng áp dụng cho các bản sao.

  • Người dùng đạt đến hạn mức 750 GB hoặc tải tệp lớn hơn 750 GB lên sẽ không thể tải lên hoặc sao chép thêm tệp cho đến khi hết 24 giờ.

  • Kích thước tệp tối đa mà người dùng có thể tải lên là 5 TB; chỉ tệp đầu tiên vượt quá giới hạn mới hoàn tất quá trình tải lên. Kích thước tệp tối đa mà người dùng có thể sao chép là 750 GB.

  • Thông báo được gửi đến địa chỉ được chỉ định khi mở kênh thông báo không được tính vào hạn mức của bạn. Tuy nhiên, các lệnh gọi đến phương thức changes.watch, channels.stop và files.watch sẽ được tính vào hạn mức của bạn.

  • Miễn là bạn không vượt quá hạn mức mỗi phút, thì số lượng yêu cầu bạn có thể thực hiện mỗi ngày là không giới hạn.

  • Tuỳ thuộc vào loại tài khoản Google Workspace, bạn có thể có thêm hạn mức bộ nhớ Drive.

Giải quyết lỗi hạn mức theo thời gian

Đối với tất cả lỗi dựa trên thời gian (tối đa N yêu cầu mỗi X phút), bạn nên để mã của mình phát hiện ngoại lệ và sử dụng thuật toán thời gian đợi luỹ thừa bị cắt bớt để đảm bảo thiết bị của bạn không tạo ra tải quá mức.

Thuật toán thời gian đợi luỹ thừa là một chiến lược xử lý sai số chuẩn cho các ứng dụng mạng. Thuật toán thời gian đợi luỹ thừa sẽ thử lại các yêu cầu bằng cách tăng thời gian chờ theo cấp luỹ thừa giữa các yêu cầu, cho đến thời gian đợi tối đa. Nếu yêu cầu vẫn không thành công, thì điều quan trọng là độ trễ giữa các yêu cầu phải tăng dần theo thời gian cho đến khi yêu cầu thành công.

Thuật toán mẫu

Thuật toán thời gian đợi luỹ thừa sẽ thử lại các yêu cầu theo cấp luỹ thừa, tăng thời gian chờ giữa các lần thử lại cho đến khi đạt thời gian đợi tối đa. Ví dụ:

  1. Gửi yêu cầu đến API Google Drive.
  2. Nếu yêu cầu không thành công, hãy đợi 1 + random_number_milliseconds rồi thử lại yêu cầu.
  3. Nếu yêu cầu không thành công, hãy đợi 2 + random_number_milliseconds rồi thử lại yêu cầu.
  4. Nếu yêu cầu không thành công, hãy đợi 4 + random_number_milliseconds rồi thử lại yêu cầu.
  5. Cứ như vậy, tối đa maximum_backoff lần.
  6. Tiếp tục chờ và thử lại cho đến khi đạt số lần thử lại tối đa, nhưng không tăng thời gian chờ giữa các lần thử lại.

trong đó:

  • Thời gian chờ là min(((2^n)+random_number_milliseconds), maximum_backoff), với n tăng thêm 1 cho mỗi lần lặp (yêu cầu).
  • random_number_milliseconds là một số mili giây ngẫu nhiên nhỏ hơn hoặc bằng 1.000. Điều này giúp tránh trường hợp nhiều ứng dụng khách được đồng bộ hoá theo một số tình huống và tất cả đều thử lại cùng một lúc, gửi yêu cầu theo các đợt đồng bộ hoá. Giá trị của random_number_milliseconds được tính toán lại sau mỗi yêu cầu thử lại.
  • maximum_backoff thường là 32 hoặc 64 giây. Giá trị phù hợp phụ thuộc vào trường hợp sử dụng.

Ứng dụng có thể tiếp tục thử lại sau khi đạt đến thời gian maximum_backoff. Sau thời điểm này, các lần thử lại không cần tiếp tục tăng thời gian đợi. Ví dụ: nếu ứng dụng khách sử dụng thời gian maximum_backoff là 64 giây, thì sau khi đạt đến giá trị này, ứng dụng khách có thể thử lại sau mỗi 64 giây. Tại một thời điểm nào đó, bạn nên ngăn ứng dụng thử lại vô thời hạn.

Thời gian chờ giữa các lần thử lại và số lần thử lại phụ thuộc vào trường hợp sử dụng và điều kiện mạng của bạn.

Giá

Mọi hoạt động sử dụng API Google Drive theo cách thông thường đều không mất thêm phí. Nếu vượt quá giới hạn yêu cầu của hạn mức, bạn sẽ phải trả phí cho tài khoản thanh toán trên Google Cloud vào cuối năm 2026. Để biết thêm thông tin, hãy xem bài viết Mô hình chuẩn hoá của Google Workspace cho các công cụ và API của tác nhân.

Yêu cầu tăng hạn mức

Tuỳ thuộc vào mức sử dụng tài nguyên của dự án, bạn có thể yêu cầu điều chỉnh hạn mức. Các lệnh gọi API của một tài khoản dịch vụ được coi là sử dụng một tài khoản duy nhất. Việc đăng ký hạn mức điều chỉnh không đảm bảo rằng bạn sẽ được phê duyệt. Những yêu cầu điều chỉnh hạn mức có thể làm tăng đáng kể giá trị hạn mức có thể mất nhiều thời gian hơn để được phê duyệt.

Không phải dự án nào cũng có hạn mức giống nhau. Khi bạn sử dụng Google Cloud ngày càng nhiều theo thời gian, có thể bạn sẽ cần tăng giá trị hạn mức. Nếu dự kiến mức sử dụng sẽ tăng đáng kể trong thời gian tới, bạn có thể chủ động yêu cầu điều chỉnh hạn mức trên trang Hạn mức và giới hạn hệ thống trong Google Cloud Console.

Để tìm hiểu thêm, hãy xem các tài nguyên sau:

Hạn mức máy chủ MCP cho Drive

Máy chủ MCP của Drive sử dụng chỉ số phân bổ chi phí truy vấn. Các bảng sau đây trình bày chi tiết chi phí truy vấn cho từng phương thức của máy chủ MCP Drive theo phần:

Hạn mức MCP cho Drive

Có hai loại hạn mức được áp dụng:

  • Mỗi phút cho mỗi dự án trên đám mây: Đây là chi phí truy vấn cho dự án Google Cloud của bạn trong một phút.

  • Mỗi phút cho mỗi người dùng trên mỗi dự án: Đây là chi phí truy vấn cho dự án trên đám mây của bạn trong một phút mà bất kỳ người dùng cụ thể nào cũng có thể sử dụng.

Bảng sau đây trình bày chi tiết về các hạn mức này:

Loại hạn mức sử dụng Hạn mức
Mỗi phút mỗi dự án 325.000
Mỗi phút cho mỗi người dùng trên mỗi dự án 1.000.000

Hạn mức của bộ công cụ MCP cho Drive

Bảng sau đây trình bày chi tiết chi phí truy vấn cho từng drivemcp.googleapis.com bộ công cụ:

Điểm cuối Công cụ Chi phí truy vấn

/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

Để biết thêm thông tin, hãy xem Tài liệu tham khảo về API Drive MCP.