Hạn mức dựa trên tài nguyên

Tài liệu này mô tả hệ thống Hạn mức dựa trên tài nguyên cho API Báo cáo của Google Analytics phiên bản 4. Tính năng này chỉ dành cho khách hàng Analytics 360. Xem Hạn mức và giới hạn API để biết tập hợp đầy đủ các giới hạn được áp dụng cho các API.

Tính năng hạn mức dựa trên tài nguyên hiện đã được cung cấp cho tất cả khách hàng Analytics 360!

Giới thiệu

Để đảm bảo tính sẵn có và độ tin cậy của các tài nguyên dùng chung, mọi dự án truy cập vào API Báo cáo Analytics đều phải tuân theo các giới hạn và hạn mức. Khi truy vấn các tập dữ liệu lớn, tính năng lấy mẫu có thể được API Báo cáo Analytics sử dụng. Điều này có thể ảnh hưởng đến kết quả dữ liệu của bạn.

Hệ thống hạn mức dựa trên tài nguyên là một hệ thống hạn mức mới cho phép các tài khoản Analytics 360 có ngưỡng lấy mẫu cao hơn trong khi sử dụng Analytics Reporting API. Hệ thống này là không bắt buộc và độc lập với các giới hạn hiện có đối với khung hiển thị và dự án, chẳng hạn như các giới hạn được báo cáo trên trang hạn mức của Google API Console.

Hạn mức dựa trên tài nguyên

Không phải tất cả các yêu cầu đều được tạo như nhau; một số yêu cầu tính toán đắt hơn nhiều so với các yêu cầu khác. Hệ thống hạn mức dựa trên tài nguyên được thiết kế để hỗ trợ ngưỡng lấy mẫu cao hơn trong khi vẫn bảo vệ cơ sở hạ tầng Báo cáo của Analytics.

Mỗi thuộc tính sẽ được phân bổ một số lượng mã thông báo tài nguyên truy vấn. Ứng dụng API có thể thêm một trường không bắt buộc vào yêu cầu API để đạt ngưỡng lấy mẫu cao hơn để đổi lấy mã thông báo tài nguyên truy vấn tương đối. Một yêu cầu tốn kém hơn so với tính toán sẽ cần nhiều mã thông báo hơn.

Ngưỡng lấy mẫu

Yêu cầu dữ liệu sử dụng API Google Analytics phiên bản 4 phải tuân theo các ngưỡng lấy mẫu chung sau đây dựa trên số phiên trong phạm vi ngày được yêu cầu (ở cấp tài sản):

• Analytics chuẩn: 500 nghìn phiên
• Analytics 360: 1 triệu phiên
• Analytics 360 sử dụng hạn mức dựa trên tài nguyên: 100 triệu phiên hoạt động

Bật hạn mức dựa trên tài nguyên

Để bật hạn mức dựa trên tài nguyên cho một yêu cầu nhất định, lệnh gọi API phải bao gồm trường không bắt buộc useResourceQuotas trong phương thức batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Ví dụ:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Trường phản hồi chi phí tài nguyên truy vấn

Đối với mỗi lệnh gọi đến phương thức batchGet, phản hồi sẽ có một trường queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Trường queryCost là một số nguyên thể hiện tổng chi phí tài nguyên của toàn bộ ReportRequests trong yêu cầu batchGet. Ví dụ:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Phân bổ hạn mức

Hạn mức tài sản Analytics 360

• 100.000 đơn vị chi phí truy vấn mỗi ngày trên mỗi tài sản.
• 25.000 đơn vị chi phí truy vấn mỗi giờ cho mỗi thuộc tính.

Nếu vượt quá hạn mức, bạn sẽ gặp lỗi RESOURCE_EXHAUSTED. Xem phần Phản hồi lỗi để biết thông tin chi tiết.

Lưu ý: Các giá trị này chỉ là sơ bộ và có thể thay đổi trong và/hoặc sau giai đoạn thử nghiệm beta.

Lưu ý quan trọng: Hạn mức hằng ngày sẽ làm mới vào lúc nửa đêm theo giờ PST.

Tính toán chi phí

Chi phí của một yêu cầu tỷ lệ với:

• Kích thước của phạm vi ngày.
• Số lượt truy cập trong chế độ xem.
• Số lượng giá trị riêng biệt của các phương diện được yêu cầu.
• Số lượng phương diện và chỉ số được yêu cầu.
• Độ phức tạp của phân đoạn và định nghĩa bộ lọc.
• Trạng thái xử lý của thông tin đã yêu cầu (việc yêu cầu dữ liệu của hôm nay sẽ tốn kém hơn so với việc yêu cầu dữ liệu của ngày hôm qua).
• Sự hiện diện của thứ nguyên và chỉ số Nhập thời gian truy vấn.

Lưu ý: Nếu một yêu cầu bị hết thời gian chờ, dẫn đến phản hồi 5XX, thì chi phí hạn mức tài nguyên vẫn sẽ phát sinh. Hãy xem trang Error Response (Phản hồi lỗi) để biết thông tin chi tiết về cách triển khai thuật toán thời gian đợi luỹ thừa nhằm ngăn việc sử dụng quá hạn mức.

Mức sử dụng và giới hạn API

Ngoài hệ thống hạn mức dựa trên tài nguyên, các API cũng chịu sự điều chỉnh của các giới hạn và hạn mức trong API Analytics phiên bản 4.

Ghi chú

• Trường phản hồi queryCost thể hiện chi phí tính toán của một yêu cầu. API này không mất phí và bạn có thể sử dụng miễn phí.
• Các báo cáo trong ngày và một số dữ liệu trong quá khứ (từ 1 năm trở lên) có thể vẫn được lấy mẫu, bất kể chế độ cài đặt useResourceQuotas.
• Nếu không thể đáp ứng ngưỡng lấy mẫu cao hơn cho một yêu cầu, mã thông báo hạn mức tài nguyên sẽ không bị khấu trừ (phản hồi được mẫu luôn có chi phí hạn mức tài nguyên bằng 0).
• Báo cáo chứa dữ liệu được lấy mẫu nếu các trường samplesReadCounts, samplingSpaceSizes xuất hiện trong phản hồi.

Để xem hoặc thay đổi hạn mức sử dụng cho dự án hoặc để yêu cầu tăng hạn mức, hãy làm như sau:

1. Nếu bạn chưa có tài khoản thanh toán cho dự án của mình, hãy tạo một tài khoản.
2. Truy cập trang API đã bật của thư viện API trong Bảng điều khiển API, chọn một API từ danh sách.
3. Để xem và thay đổi chế độ cài đặt liên quan đến hạn mức, hãy chọn Hạn mức. Để xem thống kê sử dụng, hãy chọn Mức sử dụng.