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)

必須。少なくとも 1 つの条件が必要で、最大 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 が真の場合、「次と等しい」比較は「等しくない」として扱われます。

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」に設定して、その名前をその場で変更することもできます。

parameterValue

string

必須。実行する値のミューテーション。* 100 文字未満にする必要があります。* パラメータの定数値を指定するには、値の文字列を使用します。* 別のパラメータから値をコピーするには、「[[other_parameter]]」のような構文を使用します。詳しくは、こちらのヘルプセンター記事をご覧ください。

Methods

create

EventCreateRule を作成します。

delete

EventCreateRule を削除します。

get

単一の EventCreateRule のルックアップ。

list

ウェブデータ ストリームの EventCreateRules を一覧表示します。

patch

EventCreateRule を更新します。