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)

不得為「不」的篩選運算式 (反向、互補)。只能加入篩選器。這項設定無法在頂層 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

空值篩選器。
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

 更新子資源「事件篩選器」。