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 引用此计算指标时，会使用 calculatedMetricId。例如，“calcMetric:{calculatedMetricId}”。
metricUnit

enum (MetricUnit)

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

enum (RestrictedMetricType)

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

string

必需。计算指标的定义。引用的唯一自定义指标数量上限为 5。公式支持以下运算：+（加）、-（减）、-（负）、*（乘）、/（除）、()（括号）。任何有效的实数都可以接受，只要它们适合 Long（64 位整数）或 Double（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

 列出媒体资源中的 CalculatedMetric。

patch

 更新媒体资源中的 CalculatedMetric。