Data API có các hạn mức và giới hạn sau.
Cách áp dụng hạn mức
Tất cả các yêu cầu gửi đến Google Analytics Data API phiên bản 1 đều yêu cầu một dự án trên Google Cloud và phải tuân theo hạn mức được nêu trên trang này. Hạn mức được sử dụng bất kể phương thức dùng để xác định dự án gọi, bao gồm:
- Các yêu cầu được xác thực bằng thông tin đăng nhập OAuth 2.0.
- Các yêu cầu chỉ được xác thực bằng khoá API.
Khoá API được dùng để liên kết một yêu cầu với một dự án trên đám mây cụ thể trên Google Cloud cho mục đích hạn mức và thanh toán. Tất cả các lệnh gọi API được thực hiện bằng thông tin đăng nhập hoặc khoá API từ dự án của bạn sẽ được tính vào hạn mức áp dụng của dự án và tài sản Google Analytics.
Danh mục hạn mức
Data API có 3 danh mục hạn mức yêu cầu: Lõi, Theo thời gian thực và Phễu. Các yêu cầu API đối với các phương thức Core sẽ tính vào hạn mức Core. Các yêu cầu API đối với phương thức theo thời gian thực sẽ tính vào hạn mức theo thời gian thực. Mỗi yêu cầu chỉ sử dụng một loại hạn mức.
| Danh mục hạn mức | Phương thức API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Theo thời gian thực | runRealtimeReport |
| Phễu | runFunnelReport |
Hạn mức tài sản Analytics
Tất cả các yêu cầu đều sử dụng hạn mức tài sản.
| Tên hạn mức | Hạn mức đối với tài sản chuẩn | Giới hạn đối với tài sản Analytics 360 |
|---|---|---|
| Số mã thông báo cốt lõi cho mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số mã thông báo cốt lõi trên mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số lượng token cốt lõi cho mỗi dự án, mỗi tài sản, mỗi giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời cốt lõi cho mỗi tài sản | 10 | 50 |
| Lỗi máy chủ chính theo dự án, theo tài sản, theo giờ | 10 | 50 |
| Số mã thông báo theo thời gian thực cho mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số mã thông báo theo thời gian thực trên mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số mã thông báo theo thời gian thực cho mỗi dự án, mỗi tài sản, mỗi giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời theo thời gian thực cho mỗi tài sản | 10 | 50 |
| Lỗi máy chủ theo thời gian thực cho mỗi dự án, mỗi tài sản, mỗi giờ | 10 | 50 |
| Số mã thông báo cho phễu mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số mã thông báo phễu trên mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số mã thông báo của phễu trên mỗi dự án, mỗi tài sản, mỗi giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời trên phễu cho mỗi tài sản | 10 | 50 |
| Lỗi máy chủ trong phễu theo dự án, theo tài sản, theo giờ | 10 | 50 |
- Số yêu cầu đồng thời được đo bằng số lượng yêu cầu đang được thực thi đồng thời. Để giảm số lượng yêu cầu đồng thời, hãy đợi các yêu cầu trước đó hoàn tất rồi mới gửi thêm yêu cầu.
- Lỗi máy chủ là mã 500 và 503. Hạn mức Lỗi máy chủ chỉ được tính khi một yêu cầu dẫn đến lỗi máy chủ. Khi hạn mức Lỗi máy chủ đã hết cho một cặp dự án và tài sản, tất cả các yêu cầu đến tài sản từ dự án đó sẽ bị chặn. Để xem danh sách đầy đủ các phản hồi lỗi, hãy xem phần Phản hồi lỗi.
- Mỗi yêu cầu sẽ sử dụng hạn mức cho cả Mã thông báo cho mỗi tài sản mỗi giờ và Mã thông báo cho mỗi dự án cho mỗi tài sản mỗi giờ. Điều này có nghĩa là một tài sản phải được truy cập bởi hơn 3 dự án thì hạn mức "Số mã thông báo trên mỗi tài sản mỗi giờ" mới có thể hết trước hạn mức "Số mã thông báo trên mỗi dự án trên mỗi tài sản mỗi giờ".
Mỗi giờ, các tài sản được phép gửi 120 yêu cầu có thể đạt đến ngưỡng. Các phương diện userAgeBracket, userGender, brandingInterest, audienceId và audienceName có thể được đặt ngưỡng. Chúng tôi dùng ngưỡng dữ liệu để không ai có thể suy luận ra thông tin nhân khẩu học hoặc mối quan tâm của người dùng trong khi xem báo cáo.
Hạn mức mã thông báo tài sản
Mỗi yêu cầu gửi đến Google Analytics Data API phiên bản 1 sẽ tiêu thụ mã thông báo. Số lượng mã thông báo được tính phí phụ thuộc vào độ phức tạp của yêu cầu. Mặc dù hầu hết các yêu cầu sẽ tính phí 10 mã thông báo trở xuống, nhưng các yêu cầu phức tạp hơn sẽ tiêu thụ nhiều mã thông báo hơn.
Các yếu tố ảnh hưởng đến mức tiêu thụ mã thông báo
Chi phí chính xác của mã thông báo cho một yêu cầu được xác định tại thời điểm thực thi, khiến việc tính toán trước một cách chính xác trở nên khó khăn. Chi phí chịu ảnh hưởng của nhiều yếu tố liên quan đến chính yêu cầu và dữ liệu cơ bản trong tài sản Google Analytics. Những yếu tố này có thể dẫn đến chi phí cao hơn:
- Số hàng: Yêu cầu số lượng hàng lớn hơn.
- Số lượng phương diện và chỉ số: Bao gồm nhiều phương diện và chỉ số hơn.
- Độ phức tạp của bộ lọc: Sử dụng các biểu thức bộ lọc phức tạp.
- Độ dài phạm vi ngày: Truy vấn trong khoảng thời gian dài hơn.
- Số lượng giá trị riêng biệt của dữ liệu: Những phương diện có số lượng giá trị riêng biệt cao (nhiều giá trị riêng biệt, chẳng hạn như
pagePath, phương diện tuỳ chỉnh) có thể làm tăng đáng kể chi phí mã thông báo. - Số lượng sự kiện của tài sản: Các truy vấn trên những tài sản có số lượng sự kiện lớn hơn có thể sử dụng nhiều mã thông báo hơn so với cùng một truy vấn trên một tài sản có ít dữ liệu hơn.
Giám sát mức sử dụng mã thông báo
Cách hiệu quả nhất để xác định chi phí mã thông báo cho các lệnh gọi API cụ thể là đưa tham số "returnPropertyQuota": true vào nội dung yêu cầu.
Sau đó, phản hồi của API sẽ bao gồm đối tượng PropertyQuota, trong đó nêu chi tiết về số lượng mã thông báo đã sử dụng cho yêu cầu cụ thể đó và số dư hạn mức còn lại.