REST Resource: properties.subpropertyEventFilters

منبع: SubpropertyEventFilter

یک پیام منبع نشان دهنده فیلتر رویداد فرعی GA4.

نمایندگی JSON
{
  "name": string,
  "filterClauses": [
    {
      object (SubpropertyEventFilterClause)
    }
  ],
  "applyToProperty": string
}
زمینه های
name

string

فقط خروجی قالب: خواص/{ordinary_property_id}/subpropertyEventFilters/{sub_property_event_filter} مثال: properties/1234/subpropertyEventFilters/5678

filterClauses[]

object ( SubpropertyEventFilterClause )

ضروری. لیست نامرتب. بندهای فیلتر که SubpropertyEventFilter را تعریف می کنند. همه بندها با هم AND می شوند تا مشخص شود چه داده هایی به subproperty ارسال می شود.

applyToProperty

string

تغییرناپذیر. نام منبع خاصیت فرعی که از این فیلتر استفاده می کند.

SubpropertyEventFilterClause

بند برای تعریف فیلتر. یک فیلتر ممکن است فراگیر باشد (رویدادهایی که بند فیلتر را برآورده می‌کنند در داده‌های ویژگی فرعی گنجانده شده است) یا انحصاری (رویدادهایی که بند فیلتر را برآورده می‌کنند از داده‌های ویژگی فرعی مستثنی می‌شوند).

نمایندگی JSON
{
  "filterClauseType": enum (FilterClauseType),
  "filterExpression": {
    object (SubpropertyEventFilterExpression)
  }
}
زمینه های
filterClauseType

enum ( FilterClauseType )

ضروری. نوع بند فیلتر.

filterExpression

object ( SubpropertyEventFilterExpression )

ضروری. عبارت منطقی برای اینکه چه رویدادهایی به subproperty ارسال می شوند.

FilterClauseType

مشخص می کند که آیا این عبارت فیلتر شامل یا حذف است.

Enums
FILTER_CLAUSE_TYPE_UNSPECIFIED نوع بند فیلتر ناشناخته یا مشخص نشده است.
INCLUDE در صورت رعایت بند فیلتر، رویدادها در ویژگی Sub گنجانده می شوند.
EXCLUDE در صورت رعایت بند فیلتر، رویدادها از ویژگی Sub حذف می شوند.

SubpropertyEventFilterExpression

بیانی منطقی از فیلترهای رویداد Subproperty.

نمایندگی 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'ed با هم. فقط باید شامل عبارت notExpression یا filterCondition باشد.

notExpression

object ( SubpropertyEventFilterExpression )

یک عبارت فیلتری که نباید اصلاح شود (معکوس، تکمیل شود). فقط می تواند شامل یک فیلتر باشد. این را نمی توان در سطح بالای SubpropertyEventFilterExpression تنظیم کرد.

filterCondition

object ( SubpropertyEventFilterCondition )

فیلتری ایجاد می کند که با یک رویداد خاص مطابقت دارد. این را نمی توان در سطح بالای SubpropertyEventFilterExpression تنظیم کرد.

SubpropertyEventFilterExpressionList

فهرستی از عبارات فیلتر رویداد Subproperty.

نمایندگی JSON
{
  "filterExpressions": [
    {
      object (SubpropertyEventFilterExpression)
    }
  ]
}
زمینه های
filterExpressions[]

object ( SubpropertyEventFilterExpression )

ضروری. لیست نامرتب. فهرستی از عبارات فیلتر رویداد Subproperty

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

اختیاری. اگر درست باشد، مقدار رشته به حروف بزرگ و کوچک حساس است. اگر نادرست باشد، مطابقت به حروف بزرگ و کوچک حساس است.

MatchType

چگونه از فیلتر برای تعیین تطابق استفاده می شود.

Enums
MATCH_TYPE_UNSPECIFIED نوع تطابق ناشناخته یا مشخص نشده است.
EXACT مطابقت دقیق مقدار رشته
BEGINS_WITH با مقدار رشته شروع می شود.
ENDS_WITH با مقدار رشته به پایان می رسد.
CONTAINS حاوی مقدار رشته است.
FULL_REGEXP عبارت منظم کامل با مقدار رشته مطابقت دارد.
PARTIAL_REGEXP عبارت منظم جزئی با مقدار رشته مطابقت دارد.

مواد و روش ها

create

 یک فیلتر رویداد فرعی ایجاد می کند.

delete

 فیلتر رویداد subproperty را حذف می کند.

get

 جستجو برای فیلتر رویداد واحد فرعی.

list

 لیست تمام فیلترهای رویداد فرعی در یک ویژگی.

patch

 فیلتر رویداد فرعی را به روز می کند.