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 tài nguyên của hệ thống một cách công bằng cho người dùng, các API Google Analytics sẽ thực thi một số giới hạn và hạn mức đối với mức sử dụng của bạn.

Các hạn mức và hạn mức sau đây áp dụng cho tổng mức sử dụng API Google Analytics của bạn (không bao gồm lệnh gọi Data API) ở cấp dự án 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 API Console, 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, giá trị này được đặt thành 100 yêu cầu mỗi 100 giây cho mỗi người dùng và có thể được đ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 cho mỗi người dùng.
    • Nếu ứng dụng của bạn thực hiện tất cả các yêu cầu API từ một địa chỉ IP duy nhất (ví dụ: thay mặt cho 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 mỗi người dùng. Hãy xem Tóm tắt về các tham số truy vấn chuẩn để biết thông tin chi tiết.

Một số API có các quy định hạn chế khác. Để 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 hạn mức và hạn mức

Nếu bạn vượt quá hạn mức yêu cầu API Google Analytics, API sẽ trả về một mã lỗi 403 hoặc 429 và thông báo cho biết 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 điều chỉnh ứng dụng để sử dụng hạn mức, hãy xem bài viết Giám sát API và giới hạn mức sử dụng.