REST Resource: properties.customMetrics

Tài nguyên: CustomMetric

Định nghĩa cho một chỉ số tuỳ chỉnh.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "parameterName": string,
  "displayName": string,
  "description": string,
  "measurementUnit": enum (MeasurementUnit),
  "scope": enum (MetricScope),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ]
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên cho tài nguyên CustomMetric này. Định dạng: properties/{property}/customMetrics/{customMetric}

parameterName

string

Bắt buộc. Không thể thay đổi. Tên gắn thẻ cho chỉ số tuỳ chỉnh này.

Nếu đây là một chỉ số ở phạm vi sự kiện, thì đây là tên thông số sự kiện.

Chỉ được chứa các ký tự chữ và số, dấu gạch dưới, bắt đầu bằng một chữ cái. Độ dài tối đa là 40 ký tự cho chỉ số ở phạm vi sự kiện.

displayName

string

Bắt buộc. Tên hiển thị của chỉ số tuỳ chỉnh này như xuất hiện trong giao diện người dùng Analytics. Độ dài tối đa là 82 ký tự, bao gồm chữ và số, dấu cách và dấu gạch dưới, bắt đầu bằng một chữ cái. Tên hiển thị do hệ thống cũ tạo có thể chứa dấu ngoặc vuông, nhưng các nội dung cập nhật cho trường này sẽ không bao giờ cho phép dấu ngoặc vuông.

description

string

Không bắt buộc. Nội dung mô tả cho phương diện tuỳ chỉnh này. Độ dài tối đa là 150 ký tự.

measurementUnit

enum (MeasurementUnit)

Bắt buộc. Loại giá trị của chỉ số tuỳ chỉnh.

scope

enum (MetricScope)

Bắt buộc. Không thể thay đổi. Phạm vi của chỉ số tuỳ chỉnh này.

restrictedMetricType[]

enum (RestrictedMetricType)

Không bắt buộc. Các loại dữ liệu bị hạn chế mà chỉ số này có thể chứa. Bắt buộc đối với các chỉ số có đơn vị đo lường là TIỀN TỆ. Phải trống đối với các chỉ số có đơn vị đo lường không phải là CURRENCY.

MeasurementUnit

Các loại có thể biểu thị giá trị của chỉ số tuỳ chỉnh.

Cách biểu thị đơn vị tiền tệ có thể thay đổi trong tương lai, đòi hỏi phải có một thay đổi về API có thể gây lỗi.

Enum
MEASUREMENT_UNIT_UNSPECIFIED MeasurementUnit không được chỉ định hoặc bị thiếu.
STANDARD Chỉ số này sử dụng các đơn vị mặc định.
CURRENCY Chỉ số này đo lường một đơn vị tiền tệ.
FEET Chỉ số này đo bằng feet.
METERS Chỉ số này đo bằng mét.
KILOMETERS Chỉ số này đo bằng kilômét.
MILES Chỉ số này đo lường bằng dặm.
MILLISECONDS Chỉ số này đo lường bằng mili giây.
SECONDS Chỉ số này đo lường bằng giây.
MINUTES Chỉ số này đo lường bằng phút.
HOURS Chỉ số này đo lường theo giờ.

MetricScope

Phạm vi của chỉ số này.

Enum
METRIC_SCOPE_UNSPECIFIED Phạm vi không xác định hoặc không được chỉ định.
EVENT Chỉ số ở phạm vi sự kiện.

RestrictedMetricType

Nhãn đánh dấu dữ liệu trong chỉ số tùy chỉnh này là dữ liệu chỉ được phép cung cấp cho một số người dùng cụ thể.

Enum
RESTRICTED_METRIC_TYPE_UNSPECIFIED Loại không xác định hoặc chưa chỉ định.
COST_DATA Chỉ số báo cáo dữ liệu chi phí.
REVENUE_DATA Báo cáo chỉ số về dữ liệu doanh thu.

Phương thức

archive

Lưu trữ một CustomMetric trên một tài sản.

create

Tạo một CustomMetric.

get

Tra cứu một CustomMetric duy nhất.

list

Liệt kê CustomMetrics trên một tài sản.

patch

Cập nhật một CustomMetric trên một tài sản.