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 ra giới hạn và hạn mức cho các yêu cầu API để bảo vệ hệ thống tránh phải nhận nhiều dữ liệu hơn mức có thể xử lý, đồng thời đảm bảo phân phối công bằng các tài nguyên hệ thống. Các giới hạn và hạn mức có thể thay đổi.

Video này thảo luận các phương pháp hay nhất để quản lý hạn mức yêu cầu API Google Analytics.

Các hạn mức sau áp dụng cho API Xoá người dùng:

  • 50.000 yêu cầu cho mỗi dự án mỗi ngày, có thể tăng lên.
  • 10 truy vấn mỗi giây (QPS) cho 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à Yêu cầu/100 giây/người dùng. Theo mặc định, đối tượng này được đặt thành 100 yêu cầu/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 đối với API bị giới hạn ở mức tối đa là 10 yêu cầu/giây cho mỗi người dùng.
    • Nếu ứng dụng của bạn đưa ra tất cả yêu cầu API từ một địa chỉ IP (ví dụ: thay mặt cho người dùng của bạn), 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 bản tóm tắt các tham số truy vấn chuẩn để biết thông tin chi tiết.
  • 1,5 truy vấn mỗi giây (QPS) trên mỗi thuộc tính hoặc dự án Firebase
  • 500 truy vấn mỗi ngày (QPD) cho mỗi dự án đám mây

Vượt quá hạn mức

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

Yêu cầu hạn mức bổ sung

Bạn chỉ có thể yêu cầu tăng:

  • Số yêu cầu đọc hằng ngày trên mỗi dự án (mặc định là 50.000 yêu cầu).
  • Số yêu cầu ghi hằng ngày trên mỗi dự án (mặc định là 50 yêu cầu).

Để xem hoặc thay đổi hạn mức sử dụng cho dự án hoặc để yêu cầu tăng hạn mức, hãy làm như sau:

  1. Nếu bạn chưa có tài khoản thanh toán cho dự án của mình, hãy tạo một tài khoản.
  2. Truy cập trang API đã bật của thư viện API trong Bảng điều khiển API, chọn một API từ danh sách.
  3. Để xem và thay đổi chế độ cài đặt liên quan đến hạn mức, hãy chọn Hạn mức. Để xem thống kê sử dụng, hãy chọn Mức sử dụng.

Để yêu cầu tăng hạn mức tối đa, hãy sử dụng biểu mẫu yêu cầu hạn mức API Analytics. Hãy nhớ xem lại thông tin và làm theo hướng dẫn trong biểu mẫu yêu cầu hạn mức trước khi gửi yêu cầu.

Để biết thêm thông tin về việc quản lý hạn mức và cách tinh chỉnh ứng dụng của bạn để 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.