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.

Reporting APIs

Các hạn mức sau đây áp dụng cho tất cả các API Báo cáo, bao gồm API Báo cáo chính phiên bản 3, API Báo cáo Analytics phiên bản 4, API Thời gian thực phiên bản 3 và API Phễu đa kênh phiên bản 3:

  • 10.000 yêu cầu cho mỗi lượt xem (hồ sơ) mỗi ngày (không thể tăng lên)
  • 10 yêu cầu đồng thời cho mỗi lượt xem (hồ sơ) (không thể tăng lên)

Lỗi yêu cầu API báo cáo

Nếu yêu cầu API Báo cáo không thành công do lỗi máy chủ, bạn sẽ nhận được mã phản hồi 500 hoặc 503. Bạn có thể gửi lại yêu cầu; tuy nhiên, đừng gửi lại yêu cầu này nhiều lần nếu yêu cầu này liên tục không thành công. Google Analytics cho phép:

  • 10 yêu cầu lỗi máy chủ không thành công cho mỗi dự án trên mỗi lượt xem (hồ sơ) mỗi giờ
  • 50 yêu cầu không thành công liên quan đến lỗi máy chủ cho mỗi dự án trên mỗi lượt xem (hồ sơ) mỗi ngày

Nếu số lượng yêu cầu không thực hiện được vượt quá các hạn mức này, bạn sẽ gặp lỗi sau:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Để giảm khả năng máy chủ yêu cầu gặp lỗi, hãy đơn giản hoá yêu cầu bằng cách: giảm phạm vi ngày, giảm số lượng phương diện trong yêu cầu hoặc giảm số lượng chỉ số trong yêu cầu.

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

Hạn mức tỷ lệ lỗi máy chủ được thực thi theo khoảng thời gian luân phiên đối với hạn mức tỷ lệ lỗi hằng giờ và hằng ngày. Một giờ sau khi xảy ra lỗi máy chủ đầu tiên của cặp khung hiển thị và dự án, hạn mức sẽ được đặt lại. Nếu một cặp dự án và khung hiển thị gửi 10 lỗi máy chủ trong một giờ, thì cặp dự án và khung hiển thị sẽ bị chặn khỏi API cho đến một giờ sau khi lỗi máy chủ đầu tiên trôi qua.

Ví dụ: nếu một cặp dự án và khung hiển thị không gửi lỗi máy chủ trong 24 giờ qua, thì dự án và khung hiển thị này sẽ sử dụng 0 trong số 50 hạn mức. Giả sử dự án và khung hiển thị này hiện gửi một lỗi máy chủ vào lúc 6:12 sáng. Nếu dự án và khung hiển thị này gửi thêm 49 lỗi máy chủ trước 6:12 sáng ngày hôm sau, thì dự án và khung hiển thị này sẽ bị chặn cho đến 6:12 sáng của ngày hôm sau. Vào 6:12 sáng ngày hôm sau, hạn mức tỷ lệ lỗi máy chủ sẽ được đặt lại hoàn toàn cho dự án và chế độ xem này.

API Báo cáo Analytics phiên bản 4

Các hạn mức này chỉ áp dụng cho API Báo cáo Analytics phiên bản 4:

  • Số yêu cầu mỗi ngày trong mỗi dự án: 50.000
  • Số yêu cầu trên mỗi lượt xem (hồ sơ) mỗi ngày: 10.000 (không thể tăng lên)
  • Số yêu cầu trong mỗi 100 giây trong mỗi dự án: 2.000
  • Số yêu cầu trong mỗi 100 giây trên mỗi người dùng ở mỗi dự án: 100 (có thể tăng trong Google API Console lên 1.000).

Bạn có thể xem hạn mức của dự án trong Google API Console.

Hạn mức dựa trên tài nguyên

Analytics Reporting API phiên bản 4 cũng chịu sự điều chỉnh của Hạn mức dựa trên tài nguyên (không bắt buộc), cho phép sử dụng các ngưỡng lấy mẫu cao hơn cho khách hàng Analytics 360.

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.