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

更新子資源事件篩選器。