REST Resource: properties.subpropertyEventFilters

المورد: SubpropertyEventFilter

رسالة مورد تمثّل فلتر أحداث موقع فرعي على "إحصاءات Google 4".

تمثيل 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 ويتم ربط جميع العبارات معًا لتحديد البيانات التي يتم إرسالها إلى الموقع الفرعي.

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، تكون قيمة السلسلة حسّاسة لحالة الأحرف. وإذا كانت القيمة خاطئة، تكون المطابقة غير حساسة لحالة الأحرف.

MatchType

كيفية استخدام الفلتر لتحديد المطابقة

عمليات التعداد
MATCH_TYPE_UNSPECIFIED نوع المطابقة غير معروف أو لم يتم تحديده.
EXACT المطابقة التامة لقيمة السلسلة.
BEGINS_WITH تبدأ بقيمة السلسلة.
ENDS_WITH تنتهي بقيمة السلسلة.
CONTAINS يحتوي على قيمة السلسلة.
FULL_REGEXP يتطابق التعبير العادي الكامل مع قيمة السلسلة.
PARTIAL_REGEXP يتطابق التعبير العادي الجزئي مع قيمة السلسلة.

الطُرق

create

تُنشئ فلترًا لأحداث موقع فرعي.

delete

يؤدي إلى حذف فلتر أحداث موقع فرعي.

get

ابحث عن فلتر أحداث واحد للموقع الفرعي.

list

أدرِج جميع فلاتر أحداث المواقع الفرعية في موقع معيّن.

patch

لتعديل فلتر أحداث الموقع الفرعي.