REST Resource: properties.subpropertyEventFilters

资源:SubpropertyEventFilter

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

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

string

仅限输出。格式:property/{ordinary_property_id}/subpropertyEventFilters/{sub_property_event_filter} 示例:property/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 连接在一起的表达式列表。只能包含 not 表达式 或 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

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