Do API Google Drive là một dịch vụ dùng chung, nên chúng tôi sẽ áp dụng các hạn mức và giới hạn để đảm bảo API này được mọi người dùng sử dụng công bằng, cũng như để bảo vệ hiệu suất chung của hệ thống Google Workspace.
Thông báo được gửi đến địa chỉ được chỉ định khi mở kênh thông báo sẽ không tính vào hạn mức 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.
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 hạn mức 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: Too many
requests. 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. Miễn là bạn tuân thủ hạn mức mỗi phút bên dưới, bạn có thể gửi số lượng yêu cầu không giới hạn mỗi ngày.
Bảng sau đây trình bày chi tiết các giới hạn về truy vấn:
| Hạn mức | |||||
|---|---|---|---|---|---|
| Cụm từ tìm kiếm |
|
||||
Giải quyết lỗi hạn mức dựa trên 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 sử dụng mã để phát hiện ngoại lệ và sử dụng thời gian đợi lũy thừa bị cắt bớt để đảm bảo thiết bị của bạn không tạo ra quá nhiều tải.
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 sử dụng thời gian chờ tăng theo cấp số nhân giữa các yêu cầu, lên đến thời gian đợi tối đa. Nếu yêu cầu vẫn không thành công, bạn cần tăng độ trễ giữa các yêu cầu 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 lên đến thời gian đợi tối đa. Ví dụ:
- Gửi yêu cầu đến API Google Drive.
- Nếu yêu cầu không thành công, hãy đợi 1 +
random_number_millisecondsrồi thử lại yêu cầu. - Nếu yêu cầu không thành công, hãy đợi 2 +
random_number_millisecondsrồi thử yêu cầu lại. - Nếu yêu cầu không thành công, hãy đợi 4 +
random_number_millisecondsrồi thử lại yêu cầu. - Và cứ tiếp tục như vậy, tối đa
maximum_backofflần. - Tiếp tục chờ và thử lại tối đa một số lần thử lại, 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), trong đóntăng thêm 1 cho mỗi lần lặp (yêu cầu). random_number_millisecondslà 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 được đồng bộ hoá theo một số tình huống và tất cả ứng dụng thử lại cùng một lúc, gửi yêu cầu theo các wave đã được đồng bộ hoá. Giá trị củarandom_number_millisecondssẽ được tính toán lại sau mỗi yêu cầu thử lại.maximum_backoffthường là 32 hoặc 64 giây. Giá trị thích 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 đợi. 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 đó, 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.
Giá
Mọi hoạt động sử dụng API Google Drive đều được cung cấp miễn phí. Việc vượt quá giới hạn yêu cầu trong hạn mức sẽ không bị tính thêm phí và tài khoản của bạn sẽ không bị tính phí.
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 tăng hạn mức. Lệnh gọi API của 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ý tăng hạn mức không đảm bảo rằng bạn sẽ được phê duyệt. Việc tăng hạn mức lớn 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ó cùng hạn mức. Khi bạn sử dụng Google Cloud ngày càng nhiều, hạn mức của bạn 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 trong Google Cloud Console.
Để tìm hiểu thêm, hãy xem các tài nguyên sau: