REST Resource: properties.dataStreams.eventCreateRules

المورد: EventCreateRule

تحدِّد قاعدة إنشاء الحدث الشروط التي ستؤدي إلى إنشاء حدث جديد تمامًا استنادًا إلى المعايير المتطابقة لحدث المصدر. يمكن تحديد تعديلات إضافية في المَعلمات من الحدث المصدر.

على عكس قواعد "تعديل الحدث"، لا يكون لقواعد إنشاء الحدث ترتيب محدد. وسيتم تشغيلها جميعًا بشكل مستقل.

لا يمكن استخدام قواعد "تعديل الحدث" و"إنشاء الحدث" لتعديل حدث تم إنشاؤه من قاعدة "إنشاء حدث".

تمثيل JSON 
{
  "name": string,
  "destinationEvent": string,
  "eventConditions": [
    {
      object (MatchingCondition)
    }
  ],
  "sourceCopyParameters": boolean,
  "parameterMutations": [
    {
      object (ParameterMutation)
    }
  ]
}
الحقول
name

string

النتائج فقط. اسم المورد لمورد EventCreateRule هذا. التنسيق: properties/{property}/dataStreams/{dataStream}/eventCreateRules/{eventCreateRule}
destinationEvent

string

مطلوبة. اسم الحدث الجديد المطلوب إنشاؤه

يجب أن: * أقل من 40 حرفًا * تتكون فقط من أحرف أو أرقام أو _ (شُرَط سفلية) * تبدأ بحرف.
eventConditions[]

object (MatchingCondition)

مطلوبة. يجب أن يتضمّن شرطًا واحدًا على الأقل، ويمكن أن يتضمّن ما يصل إلى 10 شروط كحدّ أقصى. ويجب أن تتطابق الشروط في الحدث المصدر حتى يتم تطبيق هذه القاعدة.
sourceCopyParameters

boolean

إذا كانت القيمة "صحيح"، يتم نسخ مَعلمات المصدر إلى الحدث الجديد. في حال ضبط هذه السياسة على "خطأ" أو تركها بدون ضبط، لن يتم نسخ جميع المَعلمات غير الداخلية من الحدث المصدر. يتمّ تطبيق تغييرات المَعلمات بعد نسخ المَعلمات.
parameterMutations[]

object (ParameterMutation)

تحدّد التغييرات في المَعلمات سلوك المَعلمة في الحدث الجديد، ويتمّ تطبيقها بالترتيب. يمكن تطبيق 20 طفرة بحدٍّ أقصى.

MatchingCondition

تحدِّد شرطًا عندما تنطبق قاعدة إنشاء حدث أو تعديل حدث على حدث معيّن.

تمثيل JSON 
{
  "field": string,
  "comparisonType": enum (ComparisonType),
  "value": string,
  "negated": boolean
}
الحقول
field

string

مطلوبة. اسم الحقل الذي تتم مقارنته بالشرط. إذا تم تحديد 'eventName'، سينطبق هذا الشرط على اسم الحدث. وبخلاف ذلك، سيتم تطبيق الشرط على مَعلمة بالاسم المحدّد.

لا يمكن أن تحتوي هذه القيمة على مسافات.
comparisonType

enum (ComparisonType)

مطلوبة. نوع المقارنة التي سيتم تطبيقها على القيمة.
value

string

مطلوبة. القيمة التي تتم مقارنتها لهذا الشرط. قد ينفّذ تنفيذ وقت التشغيل فرض نوع هذه القيمة لتقييم هذا الشرط استنادًا إلى نوع قيمة المَعلمة.
negated

boolean

ما إذا كان يجب نفي نتيجة المقارنة أم لا. على سبيل المثال، إذا كانت قيمة negated صحيحة، ستعمل مقارنات "يساوي" على أنّها "لا يساوي".

ComparisonType

نوع المقارنة لشرط المطابقة

عمليات التعداد
COMPARISON_TYPE_UNSPECIFIED غير معروف
EQUALS يساوي، حسّاس لحالة الأحرف
EQUALS_CASE_INSENSITIVE يساوي، غير حساس لحالة الأحرف
CONTAINS يحتوي على، حساسة لحالة الأحرف
CONTAINS_CASE_INSENSITIVE يحتوي على، غير حساس لحالة الأحرف
STARTS_WITH يبدأ بـ، مع الأخذ بالاعتبار شكل الأحرف
STARTS_WITH_CASE_INSENSITIVE يبدأ بـ، غير حساس لحالة الأحرف
ENDS_WITH ينتهي بـ، حساس لحالة الأحرف
ENDS_WITH_CASE_INSENSITIVE ينتهي بـ، غير حساس لحالة الأحرف
GREATER_THAN أكبر من
GREATER_THAN_OR_EQUAL أكبر من أو يساوي
LESS_THAN أقل من
LESS_THAN_OR_EQUAL أقل من أو يساوي
REGULAR_EXPRESSION التعبير العادي. لا تتوفّر هذه الميزة إلا لمصادر البيانات من موقع إلكتروني.
REGULAR_EXPRESSION_CASE_INSENSITIVE تعبير عادي، وغير حساس لحالة الأحرف. لا تتوفّر هذه الميزة إلا لمصادر البيانات من موقع إلكتروني.

ParameterMutation

تحدِّد هذه السياسة مَعلمة حدث لتغييرها.

تمثيل JSON 
{
  "parameter": string,
  "parameterValue": string
}
الحقول
parameter

string

مطلوبة. اسم المعلَمة المطلوب تغييرها. يجب أن تكون هذه القيمة: * أقل من 40 حرفًا. * يجب أن يكون فريدًا في جميع التعديلات ضمن القاعدة * وتتألف فقط من أحرف أو أرقام أو _ (شُرَط سفلية). وبالنسبة إلى قواعد تعديل الحدث، يمكن أيضًا ضبط الاسم على eventName لتعديل eventName في مكانه.
parameterValue

string

مطلوبة. تغيُّر القيمة المطلوب تنفيذه. * يجب أن يتألف من أقل من 100 حرف. * لتحديد قيمة ثابتة للمَعلمة، استخدِم سلسلة القيمة. * لنسخ قيمة من مَعلمة أخرى، استخدِم بنية مثل "[[other_parameter]]". ولمزيد من التفاصيل، اطّلِع على مقالة مركز المساعدة هذه.

الطُرق

create

 لإنشاء EventCreateRule

delete

 لحذف EventCreateRule

get

 ابحث عن EventCreateRule واحد.

list

 يسرد EventCreateRules في مصدر بيانات موقع إلكتروني.

patch

 تعديل EventCreateRule