Giới hạn và hạn mức đối với các yêu cầu API

Để đảm bảo hệ thống Google Analytics không nhận được nhiều dữ liệu hơn mức có thể xử lý và để đảm bảo phân phối công bằng tài nguyên của hệ thống cho người dùng, các API Google Analytics sẽ áp dụng một số giới hạn và hạn mức đối với việc sử dụng của bạn.

Các giới hạn và hạn mức sau đây áp dụng cho việc sử dụng API Google Analytics tổng thể (không bao gồm lệnh gọi Data API) ở cấp dự án trên đám mây của Google Cloud:

  • 50.000 yêu cầu mỗi dự án mỗi ngày.
  • 10 truy vấn mỗi giây (QPS) trên mỗi địa chỉ IP.
    • Trong Bảng điều khiển API, có một hạn mức tương tự được gọi là Số yêu cầu mỗi 100 giây trên mỗi người dùng. Theo mặc định, hạn mức này được đặt thành 100 yêu cầu mỗi 100 giây trên mỗi người dùng và có thể điều chỉnh thành giá trị tối đa là 1.000. Tuy nhiên, số lượng yêu cầu gửi đến API bị giới hạn ở mức tối đa là 10 yêu cầu mỗi giây trên mỗi người dùng.
    • Nếu ứng dụng của bạn thực hiện tất cả yêu cầu API từ một địa chỉ IP (ví dụ: thay mặt người dùng), hãy sử dụng tham số userIp hoặc quotaUser với mỗi yêu cầu để nhận hạn mức QPS đầy đủ cho từng người dùng.

Một số API có thêm các quy định hạn chế. Để biết thông tin chi tiết về các giới hạn và hạn mức dành riêng cho API, hãy xem các trang sau:

Lỗi liên quan đến giới hạn và hạn mức

Nếu vượt quá hạn mức yêu cầu API Google Analytics, API sẽ trả về mã lỗi 403 hoặc 429 và thông báo rằng tài khoản đã vượt quá hạn mức. Hãy xem điều khoản dịch vụ để biết thêm thông tin.

Để biết thêm thông tin về cách quản lý hạn mức và cách tinh chỉnh ứng dụng để sử dụng hạn mức, hãy xem bài viết Theo dõi API và giới hạn mức sử dụng.