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 Google Cloud cụ thể 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: 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 | 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 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 mã thông báo 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 phễu cho 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, 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 đó đều bị chặn.
- 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ể cạn kiệ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
Số lượng mã thông báo được tính cho mỗi yêu cầu, tuỳ thuộc vào độ phức tạp của yêu cầu. Hầu hết các yêu cầu sẽ tính phí 10 mã thông báo trở xuống. Khi một yêu cầu tiêu thụ một số lượng lớn mã thông báo hạn mức, thường là do những yếu tố sau:
- Số lượng hàng lớn
- 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 hiện tại của mã thông báo hạn mức tài sản. Trạng thái này chứa cả số lượng đã dùng của yêu cầu này và số lượng còn lại cho mỗi nhóm hạn mức. Ví dụ: hãy cân nhắc việc chỉ định tham số này trong RunReportRequest.