REST Resource: properties.calculatedMetrics

资源：CalculatedMetric

计算指标的定义。

JSON 表示法 
{
  "name": string,
  "description": string,
  "displayName": string,
  "calculatedMetricId": string,
  "metricUnit": enum (MetricUnit),
  "restrictedMetricType": [
    enum (RestrictedMetricType)
  ],
  "formula": string,
  "invalidMetricReference": boolean
}
字段
name

string

仅限输出。此 CalculatedMetric 的资源名称。格式：'properties/{property_id}/calculatedMetrics/{calculatedMetricId}'
description

string

可选。此计算指标的说明。长度上限为 4096 个字符。
displayName

string

必需。Google Analytics 界面中显示的此计算指标的显示名称。长度上限为 82 个字符。
calculatedMetricId

string

仅限输出。要用于计算指标的 ID。在界面中，它称为“API 名称”。

从外部 API 引用此计算指标时会使用 computeMetricId。例如，“calcMetric:{calculatedMetricId}”。
metricUnit

enum (MetricUnit)

必需。计算指标值的类型。
restrictedMetricType[]

enum (RestrictedMetricType)

仅限输出。此指标包含的受限数据类型。
formula

string

必需。计算指标的定义。唯一引用的自定义指标不得超过 5 个。公式支持以下运算：+（加法）、-（减法）、-（负）、*（乘法）、/（除法）、()（括号）。只要是长整型（64 位整数）或双精度型（64 位浮点数）的有效实数，均可接受。示例公式："( customEvent:parameterName + cartPurchaseQuantity ) / 2.0"
invalidMetricReference

boolean

仅限输出。如果为 true，则表示此计算指标包含无效的指标引用。如果使用计算指标并将 invalidMetricReference 设置为 true，任何操作都可能会失败、生成警告或产生意外结果。

MetricUnit

可能的计算指标值的表示类型。

枚举
METRIC_UNIT_UNSPECIFIED MetricUnit 未指定或缺失。
STANDARD 此指标使用默认单位。
CURRENCY 此指标衡量的是货币。
FEET 此指标表示英尺。
MILES 此指标以英里为单位。
METERS 此指标以米为单位。
KILOMETERS 此指标以公里为单位。
MILLISECONDS 此指标以毫秒为计量单位。
SECONDS 此指标衡量的是秒数。
MINUTES 此指标衡量的是分钟数。
HOURS 此指标衡量的是小时数。

RestrictedMetricType

这些标签用于标记与限制访问费用指标和/或收入指标的用户角色结合使用的计算指标数据。

枚举
RESTRICTED_METRIC_TYPE_UNSPECIFIED 类型未知或未指定。
COST_DATA 指标报告费用数据。
REVENUE_DATA 指标用于报告收入数据。

方法

create

 创建一个 CalculatedMetric。

delete

 删除属性上的 CalculatedMetric。

get

 查找单个 CalculatedMetric。

list

 列出某个属性上的 CalculatedMetrics。

patch

 更新媒体资源的 CalculatedMetric。