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}/eventCreate Rules/{eventCreateRule}
destinationEvent

string

חובה. השם של האירוע החדש שרוצים ליצור.

הערך חייב: * להיות קצר מ-40 תווים * להכיל רק אותיות, ספרות או _ (קווים תחתונים) * להתחיל באות
eventConditions[]

object (MatchingCondition)

חובה. צריך להיות לפחות תנאי אחד ואפשר להגדיר עד 10 תנאים לאירוע המקור כדי שהכלל יחול.
sourceCopyParameters

boolean

אם הערך הוא True, הפרמטרים של המקור מועתקים לאירוע החדש. אם הערך הוא False או לא מוגדר, כל הפרמטרים שאינם פנימיים לא יועתקו מאירוע המקור. מוטציות של פרמטרים חלות אחרי ההעתקה של הפרמטרים.
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 הוא TRUE, אז השוואות של 'שווה' יפעלו כ 'לא שווה'.

ComparisonType

סוג השוואה לתנאי התאמה

טיפוסים בני מנייה (enums)
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

 רשימה של כללי יצירת אירועים במקור לנתוני אתר.

patch

 מעדכן EventCreateRule.