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.

Hạn mức đượ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 trên 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 trên đám mây: Đây là số lượng đơn vị hạn mức mà dự án trên đám mây 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ố lượng đơ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 phân phối công bằng mức sử dụng cho người dùng.

  • Mỗi ngày cho mỗi dự án: Chế độ này xác định số byte tối đa mà dự án Google Cloud của bạn có thể truyền ra 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 hạn mức này:

Loại hạn mức sử dụng Hạn mức
Mỗi phút cho 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 cho 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 quy trình kiểm tra hạn mức bổ sung trên phần phụ trợ của Drive cũng có thể tạo ra một phản hồi 429: Rate limit exceeded. Nếu điều này xảy ra, bạn nên sử dụng thuật toán thời gian đợi luỹ thừa và thử lại sau.

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

Giới hạn 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 có thể sử dụng trong khoảng thời gian 24 giờ trước khi bị tính phí.

Nếu mức sử dụng dưới ngưỡng này, bạn sẽ không phải trả thêm phí và tài khoản Google Cloud của bạn sẽ không bị tính phí. Chúng tôi sẽ chia sẻ đầy đủ thông tin thanh toán vào cuối năm 2026 và thông báo trước í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 giới hạn ngưỡng hằng ngày này.

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

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

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

Hạn mức sử dụng theo phương thức

Số lượng đơ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. Bảng sau đây trình bày mức sử dụng hạn mức theo từng phương thức:

Hành động Các đơn vị hạn ngạch
Đọc các mục, chẳng hạn như files.get 5
Các mục trong danh sách, chẳng hạn như files.list 100
Tải các mục xuống, chẳng hạn như files.download 200
Chỉnh sửa các mục, chẳng hạn như files.update 50
Các thao tác khác, chẳng hạn như files.generateIds 5

Ràng buộc bổ sung

Các giới hạn sau đây sẽ được thực thi khi bạn làm việc với API Drive:

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

  • Những người dùng đạt đến hạn mức 750 GB hoặc tải tệp có dung lượng lớn hơn 750 GB lên sẽ không thể tải 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ỉ mà bạn chỉ định khi mở một kênh thông báo sẽ không được tính vào hạn mức. 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.

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

  • Tuỳ thuộc vào loại tài khoản Google Workspace bạn sử dụng, bạn sẽ có thêm hạn mức bộ nhớ trên Drive.

Giải quyết lỗi hạn mức dựa trên thời gian

Đối với tất cả các lỗi dựa trên thời gian (tối đa N yêu cầu trong X phút), bạn nên để mã của mình bắt lỗi và sử dụng thuật toán giảm thời gian chờ theo hàm mũ bị cắ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 số nhân giữa các yêu cầu, tối đa là thời gian đợi luỹ thừ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 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 số nhân, tăng thời gian chờ giữa các lần thử lại cho đến 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. Và 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 đến số lần thử lại tối đa, nhưng không tăng khoả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 các trường hợp nhiều ứng dụng đượ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 đợ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 tuỳ 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. Các lần thử lại sau thời điểm này không cần tiếp tục tăng thời gian tạm ngưng. Ví dụ: nếu một ứng dụng sử dụng thời gian maximum_backoff là 64 giây, thì sau khi đạt đến giá trị này, ứng dụng có thể thử lại sau mỗi 64 giây. Tại một thời điểm nào đó, các ứng dụng không được phép 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 tuỳ thuộc vào trường hợp sử dụng và điều kiện mạng của bạn.

Giá

Bạn có thể sử dụng miễn phí mọi tính năng tiêu chuẩn của API Google Drive. Việc vượt quá hạn mức yêu cầu dự kiến sẽ phát sinh phí cho tài khoản thanh toán Google Cloud của bạn vào cuối năm 2026. Để biết thêm thông tin, hãy xem Mô hình tiêu chuẩn 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ể muốn 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à đang 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. Các yêu cầu điều chỉnh hạn mức 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 ngày càng sử dụng Google Cloud, các giá trị hạn mức có thể cần tăng lên. 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 bảng điều khiển Google Cloud.

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