Mỗi yêu cầu API xác minh hạn mức chưa hết và sử dụng hạn mức. Nếu hết hạn mức, yêu cầu sẽ không thành công kèm theo thông báo lỗi có liên quan. Mỗi yêu cầu Data API sẽ kiểm tra một số nhóm hạn mức.
Danh mục hạn mức
Để xác định hạn mức, Data API có 3 danh mục yêu cầu: Lõi, Thời gian thực và Phễu. Các yêu cầu API đối với phương thức Lõi sẽ tính phí hạn mức Lõi. Các yêu cầu API đến phương thức Theo thời gian thực sẽ tính phí theo hạn mức Theo thời gian thực. Một yêu cầu sẽ không sử dụng cả hạn mức Chính và Hạn mức theo thời gian thực. Dưới đây là các danh mục và phương thức API:
| 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ả yêu cầu đều được tính theo hạn mức của tài sản.
| Tên hạn mức | Giới hạn thuộc tính chuẩn | Hạn mức tài sản Analytics 360 |
|---|---|---|
| Số mã thông báo cốt lõi trên 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/giờ | 40.000 | 400.000 |
| Số mã thông báo cốt lõi trên mỗi dự án/thuộc tính/giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời chính trên mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ cốt lõi trên mỗi dự án trên mỗi thuộc tính mỗi giờ | 10 | 50 |
| Số mã thông báo theo thời gian thực trên 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/giờ | 40.000 | 400.000 |
| Số mã thông báo theo thời gian thực trên mỗi dự án/tài sản/giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời theo thời gian thực trên mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ theo thời gian thực trên mỗi dự án trên mỗi thuộc tính mỗi giờ | 10 | 50 |
| Số mã thông báo phễu trên 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 phễu trên mỗi dự án/thuộc tính/giờ | 14.000 | 140.000 |
| Số yêu cầu đồng thời của phễu cho mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ phễu trên mỗi dự án trên mỗi thuộc tính mỗi giờ | 10 | 50 |
- Các yêu cầu đồng thời được đo lường bằng số lượng yêu cầu được thực thi đồng thời. Để giảm tình trạng đồng thời của yêu cầu, hãy đợi các yêu cầu trước đó hoàn tất trước khi 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 có yêu cầu Lỗi máy chủ. Khi hết hạn mức Lỗi máy chủ cho một cặp dự án và tài sản, tất cả yêu cầu đối với tài sản của dự án sẽ bị chặn.
- Mỗi yêu cầu sử dụng hạn mức cho cả Mã thông báo trên mỗi thuộc tính mỗi giờ và Mã thông báo trên mỗi dự án trên mỗi thuộc tính mỗi giờ. Điều này có nghĩa là có hơn 3 dự án truy cập vào một thuộc tính trước khi hết hạn mức "Mã thông báo trên mỗi thuộc tính mỗi giờ" trước khi đạt hạn mức "Mã thông báo trên mỗi dự án trên mỗi thuộc tính mỗi giờ".
Tài sản được phép hiển thị 120 yêu cầu có thể đạt ngưỡng mỗi giờ. Các
phương diện userAgeBracket, userGender, brandingInterest, audienceId
và audienceName có thể đã bị lập ngưỡng. Các ngưỡng được áp dụng để ngăn bất kỳ ai xem báo cáo 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 cá nhân.
Hạn mức mã thông báo thuộc tính
Mã thông báo được tính toán cho từng yêu cầu, tuỳ thuộc vào mức độ phức tạp của yêu cầu cần hoàn tất. Hầu hết các yêu cầu sẽ tính phí tối đa 10 mã thông báo. Khi một yêu cầu sử dụng một lượng lớn mã thông báo hạn mức, thì những yếu tố sau thường là do:
- Số lượng lớn các hàng
- Số lượng cột lớn
- Tiêu chí lọc phức tạp
- Phạm vi ngày dài
Với mỗi yêu cầu API, bạn có thể chỉ định "returnPropertyQuota": true trong
nội dung yêu cầu để trả về trạng thái mã thông báo hạn mức thuộc tính hiện tại. Trạng thái này chứa cả lượng tiêu thụ theo yêu cầu này và số lượng còn lại của từng nhóm hạn mức. Ví dụ: hãy cân nhắc việc chỉ định tham số này trong RunReportRequest.