資源:EventCreateRule
「事件建立規則」用來定義條件,可根據來源事件的相符條件觸發全新事件的建立作業。可以定義來源事件中的其他參數異動事件。
與「事件編輯」規則不同的是,事件建立規則未定義順序。這些 API 會各自獨立執行。
「事件編輯」和「事件建立」規則無法用來修改透過「事件建立」規則建立的事件。
JSON 表示法 |
---|
{ "name": string, "destinationEvent": string, "eventConditions": [ { object ( |
欄位 | |
---|---|
name |
僅供輸出。這項 EventCreateRule 資源的資源名稱。格式:properties/{property}/dataStreams/{dataStream}/eventCreateRules/{eventCreateRule} |
destinationEvent |
必要欄位。要建立的新事件名稱, 這個值必須:* 小於 40 個半形字元 * 只能包含英文字母、數字或 _ (底線) * 開頭須為英文字母 |
eventConditions[] |
必要欄位。至少須設定一個條件,且最多不得超過 10 個。來源事件的條件必須相符,系統才會套用這項規則。 |
sourceCopyParameters |
若為 true,來源參數就會複製到新事件。如果設為 False 或未設定,系統就不會從來源事件複製所有非內部參數。系統會在複製參數後套用參數異動。 |
parameterMutations[] |
參數異動會定義新事件的參數行為,並依序套用。最多可以套用 20 個異動。 |
MatchingCondition
定義「事件編輯」或「事件建立」規則套用至事件的條件。
JSON 表示法 |
---|
{
"field": string,
"comparisonType": enum ( |
欄位 | |
---|---|
field |
必要欄位。要與條件比較的欄位名稱。如果指定「eventName」,此條件會套用至事件名稱。否則,系統會將條件套用至具有指定名稱的參數。 此值不能包含空格。 |
comparisonType |
必要欄位。要套用至值的比較類型。 |
value |
必要欄位。要與這項條件比較的值。執行階段實作可能會執行這個值的類型強制轉換,根據參數值類型評估這個條件。 |
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 |
必要欄位。要變動的參數名稱。這個值必須:* 不得超過 40 個字元。* 規則內所有異動項目的名稱不得重複 * 只能包含字母、數字或 _ (底線)。如果是事件編輯規則,也可以將名稱設為「eventName」,以修改現有的 eventName。 |
parameterValue |
必要欄位。要執行的值異動。* 必須少於 100 個字元。* 若要為參數指定常數值,請使用該值的字串。* 如要複製其他參數的值,請使用「[[other_parameter]]」等語法。詳情請參閱這篇說明中心文章。 |
方法 |
|
---|---|
|
建立 EventCreateRule。 |
|
刪除 EventCreateRule。 |
|
查詢單一 EventCreateRule。 |
|
可列出網站資料串流的 EventCreateRules。 |
|
更新 EventCreateRule。 |