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

Google Analytics được hàng triệu trang web sử dụng. Chúng tôi đặt giới hạn và hạn mức đối với các yêu cầu API để bảo vệ hệ thống khỏi nhận nhiều dữ liệu hơn khả năng xử lý và để đảm bảo phân bổ tài nguyên hệ thống một cách công bằng. Các giới hạn và hạn mức có thể thay đổi.

Giới hạn số lượng yêu cầu

Giới hạn số lượng yêu cầu API xác định số lượng yêu cầu có thể gửi tới API Quản trị của Google Analytics. Giới hạn số lượng yêu cầu được thực thi và tự động nạp lại sau mỗi 60 giây (1 phút). Điều này có nghĩa là nếu dự án của bạn đạt đến giới hạn tốc độ tối đa tại bất kỳ thời điểm nào trong vòng 60 giây, bạn cần đợi hạn mức đó nạp lại trước khi tạo thêm yêu cầu trong nhóm đó. Nếu dự án của bạn vượt quá giới hạn số lượng yêu cầu, bạn sẽ gặp lỗi 403 với lý do rateLimitExceeded. Để khắc phục lỗi này, hãy đợi một phút rồi thử yêu cầu lại — hạn mức sẽ được nạp lại vào đầu khoảng thời gian tiếp theo.

Số lượng yêu cầu API tối đa hằng ngày bị giới hạn bởi giới hạn tốc độ API, hiện không có hạn mức sử dụng hằng ngày rõ ràng cho API Quản trị của Google Analytics.

Hạn mức cho dự án Cloud

Giới hạn số lượng yêu cầu API áp dụng theo từng dự án.

Cloud Console hiển thị hạn mức cho một dự án trên đám mây: https://console.cloud.google.com/apis/api/analyticsadmin.googleapis.com/quotas.

Dưới đây là hạn mức mặc định cho API Quản trị của Google Analytics mà hầu hết người dùng sẽ thấy trong bảng điều khiển của họ. Xin lưu ý rằng hạn mức có thể tự động được điều tiết đối với những dự án vi phạm Điều khoản dịch vụ của Google Analytics.

Tên hạn mức Hạn mức
Số yêu cầu mỗi phút 1.200
Số yêu cầu mỗi phút trên mỗi người dùng 600
Số lượt ghi mỗi phút 600
Số lượt ghi trên phút/người dùng 180

Mỗi yêu cầu gửi tới API Quản trị của Google Analytics đều sử dụng hạn mức Requests per minute, Requests per minute per user. Các yêu cầu đối với bất kỳ phương thức nào làm thay đổi cấu hình tài khoản Google Analytics theo bất kỳ cách nào (phương thức create, patch, delete, archive, update) cũng sẽ sử dụng hạn mức Writes per minuteWrites per minute per user.

Tham khảo bài viết Giới hạn mức sử dụng API để biết thông tin về cách giới hạn các yêu cầu API cho từng người dùng.