REST Resource: properties.dataStreams.eventCreateRules

资源：EventCreateRule

事件创建规则用于定义根据来源事件的匹配条件触发系统创建全新事件的条件。可以定义来源事件中参数的其他变更。

与事件修改规则不同，事件创建规则没有定义顺序。它们都将独立运行。

“事件修改”和“事件创建”规则无法用于修改根据“事件创建”规则创建的事件。

JSON 表示法 
{
  "name": string,
  "destinationEvent": string,
  "eventConditions": [
    {
      object (MatchingCondition)
    }
  ],
  "sourceCopyParameters": boolean,
  "parameterMutations": [
    {
      object (ParameterMutation)
    }
  ]
}
字段
name

string

仅限输出。此 EventCreateRule 资源的资源名称。格式：properties/{property}/dataStreams/{dataStream}/eventCreateRules/{eventCreateRule}
destinationEvent

string

必需。要创建的新事件的名称。

此值必须：* 少于 40 个字符 * 仅包含字母、数字或 _（下划线）* 以字母开头
eventConditions[]

object (MatchingCondition)

必需。必须至少有一个条件，最多可以有 10 个条件。要应用此规则，源事件中的条件必须匹配。
sourceCopyParameters

boolean

如果为 true，源参数会复制到新事件。如果此政策设为 false 或未设置，系统不会从源事件中复制所有非内部参数。参数变更将在参数复制完毕后应用。
parameterMutations[]

object (ParameterMutation)

参数变更会定义新事件的参数行为，并按顺序应用。最多可以应用 20 项更改。

MatchingCondition

定义对事件应用“事件修改”或“事件创建”规则的条件。

JSON 表示法 
{
  "field": string,
  "comparisonType": enum (ComparisonType),
  "value": string,
  "negated": boolean
}
字段
field

string

必需。与条件进行比较的字段的名称。如果指定了“eventName”，此条件将应用于事件的名称。否则，该条件将应用于具有指定名称的参数。

此值不能包含空格。
comparisonType

enum (ComparisonType)

必需。要应用于值的比较类型。
value

string

必需。与此条件进行比较的值。运行时实现可能会对此值执行类型强制转换，以根据参数值的类型评估此条件。
negated

boolean

是否应否定比较结果。例如，如果 negated 为 true，则“等于”比较运算的作用为“不等于”。

ComparisonType

匹配条件的比较类型

枚举
COMPARISON_TYPE_UNSPECIFIED 未知
EQUALS 等于，区分大小写
EQUALS_CASE_INSENSITIVE 等于，不区分大小写
CONTAINS 包含（区分大小写）
CONTAINS_CASE_INSENSITIVE 包含，不区分大小写
STARTS_WITH 开头为（区分大小写）
STARTS_WITH_CASE_INSENSITIVE 开头为（不区分大小写）
ENDS_WITH 结尾为（区分大小写）
ENDS_WITH_CASE_INSENSITIVE 结尾为（不区分大小写）
GREATER_THAN 大于
GREATER_THAN_OR_EQUAL 大于或等于
LESS_THAN 小于
LESS_THAN_OR_EQUAL 小于或等于
REGULAR_EXPRESSION 正则表达式。仅适用于网站数据流。
REGULAR_EXPRESSION_CASE_INSENSITIVE 正则表达式，不区分大小写。仅适用于网站数据流。

ParameterMutation

定义要 mutate 的事件参数。

JSON 表示法 
{
  "parameter": string,
  "parameterValue": string
}
字段
parameter

string

必需。要更改的参数的名称。此值必须：* 少于 40 个字符。* 在规则内的所有变更中必须唯一
parameterValue

string

必需。要执行的值变更。* 必须少于 100 个字符。* 要为参数指定常量值，请使用该值的字符串。* 如需从其他参数复制值，请使用“[[other_parameter]]”等语法。如需了解详情，请参阅这篇帮助中心文章。

方法

create

 创建 EventCreateRule。

delete

 删除 EventCreateRule。

get

 查找单个 EventCreateRule。

list

 列出网站数据流上的 EventCreateRules。

patch

 更新 EventCreateRule。