Hạn mức sử dụng

Vì Google Biểu mẫu 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 dịch vụ này được mọi người dùng sử dụng một cách công bằng, cũng như để bảo vệ tình trạng chung của hệ thống Google Workspace.

Nếu vượt quá hạn mức, thường thì bạn sẽ nhận được phản hồi mã trạng thái HTTP 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 duy trì trong giới hạn mỗi phút dưới đây, sẽ không có giới hạn về số yêu cầu bạn có thể thực hiện mỗi ngày.

Lưu ý: Đồng hồ biểu mẫu có các giới hạn bổ sung. Hãy xem phần Thiết lập và nhận thông báo đẩy để biết thêm thông tin.

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

Hạn mức
Yêu cầu đọc
Mỗi ngày cho mỗi dự án Vé loại không giới hạn
Mỗi phút cho mỗi dự án 975
Mỗi phút/người dùng/dự án 390
Yêu cầu đọc tốn kém

(Được sử dụng cho forms.responses.list yêu cầu.)

Mỗi ngày cho mỗi dự án Vé loại không giới hạn
Mỗi phút cho mỗi dự án 450
Mỗi phút/người dùng/dự án 180
Yêu cầu ghi
Mỗi ngày cho mỗi dự án Vé loại không giới hạn
Mỗi phút cho mỗi dự án 375
Mỗi phút/người dùng/dự án 150

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

Đối với mọi lỗi dựa trên thời gian (tối đa N yêu cầu mỗi X phút), mã của bạn nên phát hiện ngoại lệ và dùng tính nă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. 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, cho tới 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 sẽ tăng lê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 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 Google Biểu mẫu 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 maximum_backoff lần.
  6. Tiếp tục đợi và thử lại đến số lần thử lại tối đa, nhưng đừng làm tăng thời gian chờ giữa các lần thử lại.

nơi:

  • 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 (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 được đồng bộ hoá. Giá trị của random_number_milliseconds được tính toán lại sau mỗi lần yêu cầu thử lại.
  • maximum_backoff thườ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 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 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 số 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á

Bạn có thể sử dụng API Google Biểu mẫu mà không mất thêm phí. Bạn sẽ không phải trả thêm phí khi vượt quá hạn mức yêu cầu, và tài khoản của bạn 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 nên yêu cầu tăng 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ý tăng hạn mức không có nghĩa là 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ó hạn mức như nhau. Vì bạn ngày càng sử dụng Google Cloud nhiều hơn theo thời gian, nên có thể hạn mức của bạn sẽ cần phải tăng lên. Nếu dự kiến mức sử dụng sắp tăng đáng kể, 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: