REST Resource: properties.subpropertyEventFilters

المورد: SubpropertyEventFilter

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

تمثيل 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)

مطلوب. قائمة بدون ترتيب أحكام الفلترة التي تحدّد فلتر أحداث الموقع الفرعي يتمّ ربط جميع الجمل معًا باستخدام "و" لتحديد البيانات التي يتمّ إرسالها إلى الموقع الفرعي.

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)

قائمة بالتعبيرات التي سيتم ربطها ببعضها باستخدام "أو" يجب أن يحتوي على تعبيرَي 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

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