Data API có các hạn mức và hạn ngạch sau.
Cách áp dụng hạn mức
Tất cả yêu cầu gửi đến Google Analytics Data API v1 đều cần có một dự án trên Google Cloud và phải tuân theo các 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:
- Yêu cầu được xác thực bằng thông tin đăng nhập OAuth 2.0.
- Yêu cầu được xác thực chỉ bằng khoá API.
Khoá API dùng để liên kết một yêu cầu với một dự án trên đám mây của Google Cloud cho mục đích tính hạn mức và lập hoá đơn. Tất 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: Core, Theo thời gian thực và Phễu. Yêu cầu API gửi đến các phương thức Core sẽ tính hạn mức Core. Yêu cầu API gửi đến các phương thức Theo thời gian thực sẽ tính 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ả yêu cầu đều sử dụng hạn mức tài sản.
| Tên hạn mức | Giới hạn đố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 Core mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số mã thông báo Core mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số mã thông báo Core 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 Core mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ Core mỗi dự án mỗi tài sản mỗi giờ | 10 | 50 |
| Số mã thông báo theo thời gian thực 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 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 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 mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ theo thời gian thực mỗi dự án mỗi tài sản mỗi giờ | 10 | 50 |
| Số mã thông báo 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 mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số mã thông báo phễu 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 phễu mỗi tài sản | 10 | 50 |
| Số lỗi máy chủ phễu mỗi dự án mỗi tài sản mỗi giờ | 10 | 50 |
- Số yêu cầu đồng thời được đo lường bằng số yêu cầu đang được thực thi đồng thời. Để giảm số 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ả yêu cầu gửi đến tài sản đó từ dự án sẽ bị chặn.
- Mỗi yêu cầu sử dụng hạn mức cho cả Số mã thông báo mỗi tài sản mỗi giờ và Số mã thông báo mỗi dự án 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 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 mỗi dự án mỗi tài sản mỗi giờ".
Các tài sản được phép có 120 yêu cầu có thể bị áp dụng ngưỡng mỗi giờ. Các phương diện userAgeBracket, userGender, brandingInterest, audienceId và audienceName có thể bị áp dụng 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ã thông báo được sử dụng cho mỗi yêu cầu gửi đến Google Analytics Data API v1. Số mã thông báo được tính tuỳ thuộc vào mức độ 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 10 token trở xuống, nhưng các yêu cầu phức tạp hơn sẽ sử dụng nhiều hơn.
Các yếu tố ảnh hưởng đến mức sử dụng 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 cho 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 sự kết hợp giữa các 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. Các 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ố phương diện và chỉ số: Bao gồm số lượng phương diện và chỉ số lớn 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.
- Thời lượng 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: Các 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 các tài sản có số lượng sự kiện cao hơn có thể sử dụng nhiều token 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 API sẽ bao gồm đối tượng PropertyQuota, trong đó nêu chi tiết số mã thông báo mà yêu cầu cụ thể đó đã sử dụng và số dư hạn mức còn lại.