Hạn mức sử dụng

Vì API Google Biểu mẫu 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ệ tình trạng chung của hệ thống Google Workspace.

Nếu vượt quá hạn mức, bạn thường 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 đợi luỹ tuyến rồi thử lại sau. Miễn là bạn không vượt quá hạn mức mỗi phút dưới đây, 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.

Lưu ý: Trình theo dõi biểu mẫu có các giới hạn bổ sung. Hãy xem bài viết 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 về các giới hạn đối với yêu cầu:

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

(Dùng cho các yêu cầu forms.responses.list.)

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

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. Tạo một yêu cầu đối với API Google Biểu mẫu.
  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 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. 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 ứ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 thông thường đối với Google Biểu mẫu API đều không mất thêm phí. Nếu vượt quá giới hạn yêu cầu về 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 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, giá trị hạn mức của bạn có thể cần phải 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 Google Cloud Console.

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