REST Resource: properties.subpropertyEventFilters

资源：SubpropertyEventFilter

表示 GA4 子媒体资源事件过滤器的资源消息。

JSON 表示法 
{
  "name": string,
  "filterClauses": [
    {
      object (SubpropertyEventFilterClause)
    }
  ],
  "applyToProperty": string
}
字段
name

string

仅限输出。格式：properties/{ordinary_property_id}/subpropertyEventFilters/{sub_property_event_filter} 示例：properties/1234/subpropertyEventFilters/5678
filterClauses[]

object (SubpropertyEventFilterClause)

必需。无序列表。定义 SubpropertyEventFilter 的过滤子句。所有子句以 AND 关系结合在一起，以确定发送到子媒体资源的数据。
applyToProperty

string

不可变。使用此过滤条件的子媒体资源的资源名称。

SubpropertyEventFilterClause

用于定义过滤条件的子句。过滤条件可以是包含过滤器（满足过滤器子句的事件包含在子媒体资源的数据中），也可以是不含过滤器的事件（从子媒体资源的数据中排除满足过滤器子句的事件）。

JSON 表示法 
{
  "filterClauseType": enum (FilterClauseType),
  "filterExpression": {
    object (SubpropertyEventFilterExpression)
  }
}
字段
filterClauseType

enum (FilterClauseType)

必需。过滤器子句的类型。
filterExpression

object (SubpropertyEventFilterExpression)

必需。将哪些事件发送到子媒体资源的逻辑表达式。

FilterClauseType

指定此为包含过滤器还是排除过滤器子句。

枚举
FILTER_CLAUSE_TYPE_UNSPECIFIED 过滤条件子句类型未知或未指定。
INCLUDE 如果满足过滤条件子句，事件将包含在子属性中。
EXCLUDE 如果满足过滤条件子句，事件将从子媒体资源中排除。

SubpropertyEventFilterExpression

子媒体资源事件过滤器的逻辑表达式。

JSON 表示法 
{

  // Union field expr can be only one of the following:
  "orGroup": {
    object (SubpropertyEventFilterExpressionList)
  },
  "notExpression": {
    object (SubpropertyEventFilterExpression)
  },
  "filterCondition": {
    object (SubpropertyEventFilterCondition)
  }
  // End of list of possible types for union field expr.
}
字段
联合字段 expr。应用于过滤器的表达式。expr 只能是下列其中一项：
orGroup

object (SubpropertyEventFilterExpressionList)

通过 OR 运算符组合在一起的表达式列表。只能包含 notExpression 或 filterCondition 表达式。
notExpression

object (SubpropertyEventFilterExpression)

要进行 NOT（反转、补码）的过滤表达式。只能包含过滤条件。无法在顶级 SubpropertyEventFilterExpression 上设置此值。
filterCondition

object (SubpropertyEventFilterCondition)

创建与特定事件匹配的过滤条件。无法在顶级 SubpropertyEventFilterExpression 上设置此值。

SubpropertyEventFilterExpressionList

子媒体资源事件过滤器表达式列表。

JSON 表示法 
{
  "filterExpressions": [
    {
      object (SubpropertyEventFilterExpression)
    }
  ]
}
字段
filterExpressions[]

object (SubpropertyEventFilterExpression)

必需。无序列表。子媒体资源事件过滤表达式列表

SubpropertyEventFilterCondition

特定过滤表达式

JSON 表示法 
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "nullFilter": boolean,
  "stringFilter": {
    object (StringFilter)
  }
  // End of list of possible types for union field one_filter.
}
字段
fieldName

string

必需。要过滤的字段。

联合字段 one_filter。

one_filter 只能是下列其中一项：
nullFilter

boolean

null 值的过滤条件。
stringFilter

object (StringFilter)

匹配特定模式的字符串类型维度的过滤器。

StringFilter

匹配特定模式的字符串类型维度的过滤器。

JSON 表示法 
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
字段
matchType

enum (MatchType)

必需。字符串过滤条件的匹配类型。
value

string

必需。用于匹配的字符串值。
caseSensitive

boolean

可选。如果为 true，则字符串值区分大小写。如果为 false，则匹配不区分大小写。

MatchType

如何使用过滤条件来确定匹配项。

枚举
MATCH_TYPE_UNSPECIFIED 匹配类型未知或未指定。
EXACT 与字符串值完全匹配。
BEGINS_WITH 以字符串值开头。
ENDS_WITH 以字符串值结尾。
CONTAINS 包含字符串值。
FULL_REGEXP 完整的正则表达式与字符串值匹配。
PARTIAL_REGEXP 部分正则表达式与字符串值匹配。

方法

create

 创建子媒体资源事件过滤器。

delete

 删除子媒体资源事件过滤器。

get

 查找单个子媒体资源的事件过滤器。

list

 列出媒体资源上的所有子媒体资源事件过滤器。

patch

 更新子媒体资源的事件过滤器。