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 đế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:
- 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 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 tính 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: Core, Theo thời gian thực và Phễu. Các yêu cầu API đối với phương thức Core sẽ tính 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 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 | Giới hạn tài sản tiêu chuẩn | Giới hạn tài sản Analytics 360 |
|---|---|---|
| Số token Core mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số token Core mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số token 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ố token theo thời gian thực mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số token theo thời gian thực mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số token 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ố token phễu mỗi tài sản mỗi ngày | 200.000 | 2.000.000 |
| Số token phễu mỗi tài sản mỗi giờ | 40.000 | 400.000 |
| Số token 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ả 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 bài viết Phản hồi lỗi.
- Mỗi yêu cầu sử dụng hạn mức cho cả Số token mỗi tài sản mỗi giờ và Số token 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ố token mỗi tài sản mỗi giờ" mới có thể hết trước hạn mức "Số token 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ể có ngưỡng mỗi giờ. Các phương diện userAgeBracket, userGender, brandingInterest, audienceId và audienceName có thể có 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 token tài sản
Token được sử dụng với mỗi yêu cầu đến Google Analytics Data API v1. Số token được tính tuỳ 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 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 token
Chi phí token chính xác 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 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.
- Khoảng thời gian: 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í token. - 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 token
Cách hiệu quả nhất để xác định chi phí token cho các lệnh gọi API cụ thể của bạn
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ố token mà yêu cầu cụ thể đó đã sử dụng và số dư hạn mức còn lại.