Hạn mức sử dụng

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

Hạn mức sản phẩm

Bạn không thể xuất quá 20 lần trong tổ chức của mình.

Hạn mức yêu cầu API

Mỗi tổ chức được phép đọc 600 vấn đề mỗi phút trên tất cả dự án và người dùng, bao gồm cả các yêu cầu qua Google Vault API và vault.google.com.

Các bảng sau liệt kê các giới hạn yêu cầu theo phút cho từng dự án:

Đọc yêu cầu mỗi phút trên mỗi dự án
Xuất, vấn đề và truy vấn đã lưu 120
Duy trì 228
Thao tác diễn ra trong thời gian dài 300
Ghi yêu cầu mỗi phút cho mỗi dự án
Export 20
Duy trì 60
Quyền của Matter 30
Matter 60
Đã lưu truy vấn 45
Tìm kiếm (số lượng) yêu cầu mỗi phút trên mỗi dự án
Số lượt tìm kiếm 20

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

Hạn mức mà một yêu cầu sử dụng phụ thuộc vào phương thức được gọi. Bảng sau đây liệt kê mức sử dụng hạn mức cho mỗi phương thức:

Phương thức Chi phí hạn mức
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		Đã đọc 1 vấn đề
1 nội dung về vấn đề
matters.count 1 lượt
matters.get Đã đọc 1 vấn đề
matters.list 10 lượt đọc vấn đề
matters.addPermissions
matters.removePermissions 		1 vấn đề đã đọc
1 vấn đề ghi
1 quyền ghi cho vấn đề
matters.exports.create 1 lượt ghi dữ liệu xuất
10 lượt ghi dữ liệu xuất
matters.exports.delete 1 lượt ghi dữ liệu xuất
matters.exports.get Đã đọc 1 tệp xuất
matters.exports.list 5 lượt đọc xuất
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 vấn đề đã đọc
1 lượt ghi về vấn đề
1 lượt ghi yêu cầu lưu giữ dữ liệu
1 lượt ghi yêu cầu lưu giữ dữ liệu
matters.holds.list Đã đọc 1 vấn đề
3 lần đọc yêu cầu lưu giữ
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 vấn đề đã đọc
1 lượt ghi về vấn đề
1 lượt ghi yêu cầu lưu giữ dữ liệu
1 lượt ghi yêu cầu lưu giữ dữ liệu
matters.savedQueries.create
matters.savedQueries.delete 		Đã đọc 1 vấn đề
1 lượt ghi về vấn đề
1 lượt ghi truy vấn đã lưu
1 lượt ghi truy vấn đã lưu
matters.savedQueries.get Đã đọc 1 vấn đề
Đã đọc 1 truy vấn đã lưu
matters.savedQueries.list Đã đọc 1 vấn đề
3 lượt đọc truy vấn đã lưu
operations.get Đọc 1 thao tác diễn ra trong thời gian dài

Khắc phục lỗi hạn mức dựa trên thời gian

Nếu vượt quá hạn mức mỗi phút hoặc cho mỗi tổ chức, bạn thường sẽ nhận được phản hồi mã trạng thái HTTP 429: Too many requests.

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

Thuật toán thời gian đợi luỹ thừa là một chiến lược xử lý lỗi tiêu chuẩn cho các ứng dụng mạng. Một 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 dùng thời gian chờ tăng theo cấp số nhân giữa các yêu cầu, cho đến thời gian đợi tối đa. Nếu các 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 sẽ 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 tới thời gian đợi tối đa. Ví dụ:

  1. Gửi yêu cầu đến Google Vault API.
  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ứ tiếp tục như vậy, tối đa là maximum_backoff lần.
  6. Tiếp tục đợi và thử lại cho đến số lần thử lại tối đa, nhưng không làm 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 đó n tăng thêm 1 cho mỗi lần lặp lại (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 có nhiều ứng dụng được đồng bộ hoá trong 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 trong các sóng đã đồng bộ hoá. Giá trị của random_number_milliseconds sẽ được tính toán lại sau mỗi lần yêu cầu thử lại.
  • maximum_backoff thường có thời lượng 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 hết 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 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 số thời điểm, 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.

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. Các lệnh gọi API thông qua 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 ứng dụng của bạn sẽ được phê duyệt. Quá trình phê duyệt hạn mức lớn có thể mất nhiều thời gian hơn.

Không phải dự án nào cũng có cùng hạn mức. Khi ngày càng sử dụng Google Cloud theo thời gian, 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ẽ gia 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 bảng điều khiển Google Cloud.

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

Giá

Khách hàng Google Workspace có thể sử dụng Google Vault API mà không mất thêm phí.