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

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

 하위 속성 이벤트 필터를 업데이트합니다.