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

Tài liệu này mô tả các giới hạn và hạn mức trong việc yêu cầu API Quản lý và API Báo cáo.

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ông nhận được nhiều dữ liệu hơn mức mà hệ thống có thể xử lý, đồng thời để đả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.

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

Hạn mức chung

Các hạn mức sau áp dụng cho API Quản lý, API Báo cáo chính phiên bản 3, API Báo cáo MCF, API siêu dữ liệu, API Xoá người dùng và API Báo cáo theo thời gian thực:

  • 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) 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 trên 100 giây cho mỗi người dùng. Theo mặc định, hệ thống sẽ đặt thành 100 yêu cầu/100 giây cho 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 đến 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ả các yêu cầu API từ một địa chỉ IP duy nhất (tức là thay mặt cho người dùng), hãy sử dụng tham số userIP hoặc quotaUser cho mỗi yêu cầu để nhận đầy đủ hạn mức QPS cho từng người dùng. Hãy xem thông tin tóm tắt về tham số truy vấn chuẩn để biết thông tin chi tiết.

API Quản lý

Google Analytics áp dụng hạn mức cho các yêu cầu đối với các API quản lý sau:

Viết API

Các hạn mức này áp dụng cho yêu cầu ghi (insert, update, patch và delete):

  • 50 yêu cầu ghi cho mỗi dự án mỗi ngày. có thể tăng lên
  • 1,5 truy vấn mỗi giây (QPS) cho mỗi mã tài khoản

Lỗi yêu cầu ghi

Nếu yêu cầu ghi không thành công và bạn nhận được mã phản hồi 500 hoặc 503, thì bạn có thể gửi lại mã đó. Google Analytics cho phép:

  • 50 yêu cầu ghi không thành công mỗi giờ.

Nếu cố gửi hơn 50 yêu cầu ghi không thành công mỗi giờ, bạn sẽ gặp lỗi sau:

Quota Error: The number of recent failed writes is too high.

Thay vì liên tục gửi lại một yêu cầu ghi không thành công, hãy triển khai thuật toán thời gian đợi luỹ thừa để gửi lại yêu cầu đó.

API nhập dữ liệu

Những hạn mức này dành riêng cho tài nguyên Uploads:

  • Giới hạn lưu trữ Nhập dữ liệu mở rộng toàn thời gian (không áp dụng cho dữ liệu lượt truy cập được gửi từ SDK và API thu thập):
  • 50 Tập dữ liệu trên mỗi thuộc tính
  • 50 thao tác tải lên trên mỗi tài sản mỗi ngày
  • 1 GB cho mỗi tệp được tải lên
  • Các hạn mức cụ thể cho Dữ liệu chi phí:
    • 100 MB mỗi ngày (ga:date) trên mỗi tập dữ liệu. Ví dụ: nếu bạn nhập 50 MB dữ liệu cho ngày 10/10/2014 trong một lần tải lên và 50 MB dữ liệu cho ngày 10/10/2014 trong lần tải lên thứ hai, thì bạn đã đạt đến giới hạn 100 MB cho ngày 10/10/2014 đối với tập dữ liệu đó.

API thử nghiệm

Hạn mức này chỉ áp dụng cho các mục Thử nghiệm:

  • 12 Thử nghiệm cho mỗi chế độ xem (hồ sơ)

Các thử nghiệm có một trong các statuses sau đây sẽ được tính vào hạn mức này:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Các thử nghiệm đã kết thúc (trạng thái = ENDED) trong hơn một ngày không được tính vào hạn mức này.

API báo cáo chưa được lấy mẫu

Các hạn mức này chỉ áp dụng cho Báo cáo chưa được lấy mẫu:

  • Các yêu cầu API để tạo báo cáo chưa được lấy mẫu được tính vào hạn mức Ghi yêu cầu chung.
  • API sử dụng cùng một hệ thống mã thông báo mỗi tài sản, mỗi ngày mà giao diện web dùng để tạo báo cáo chưa được lấy mẫu.
  • Số lượng báo cáo chưa được lấy mẫu tối đa cho phép là 3.500. Khi đạt đến giới hạn này, việc cố gắng tạo thêm các báo cáo chưa được lấy mẫu bằng API sẽ dẫn đến lỗi sau: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

API quyền của người dùng

Hạn mức này chỉ áp dụng cho Quyền của người dùng:

  • Người dùng có thể có tối đa 100 tài khoản Analytics. Việc thêm người dùng có 100 tài khoản Analytics vào một tài khoản mới gây ra lỗi.

Các hạn mức sau đây áp dụng cho các yêu cầu ghi theo lô (delete, insert, update) đối với quyền của người dùng:

  • 300 yêu cầu ghi quyền của người dùng trong mỗi yêu cầu hàng loạt
  • 30 yêu cầu ghi quyền của người dùng theo lô được tính là 1 yêu cầu ghi

Vượt quá 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.

Đang yêu cầu hạn mức bổ sung

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

Để 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, vui lòng 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. Đối với API Báo cáo phiên bản 4, tên API trong Google API Console là Google Analytics Reporting API. Tất cả các API phiên bản 3 khác (ví dụ: API Quản lý phiên bản 3, API Báo cáo chính phiên bản 3, API Báo cáo theo thời gian thực phiên bản 3, API Xoá người dùng phiên bản 3) được liệt kê trong API Analytics trong Bảng điều khiển API của Google.

Để 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 Theo dõi API và giới hạn mức sử dụng.