イベントリクエストの作成
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
リクエスト設定が完了したら、Build() メソッドを呼び出してリクエストオブジェクトを取得できます。
var eventRequest = UTRequestBuilder.EventWithDefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .AddCustomValues("key1", "value1") .AddCustomValues("key2", "value2") .Timestamp(DateTime.Now) .Build();
リクエストを作成する際には、以下のルールを守る必要があります:
-
任意のパラメータは任意の順序で定義できます。
例えば、以下の2つのコードサンプルはどちらも正しいリクエストです。
UTRequestBuilder.SearchEvent("some keywords") .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .Timestamp(DateTime.Now) .AddCustomValues("key", "value") .Build();
UTRequestBuilder.SearchEvent("some keywords") .AddCustomValues("key", "value") .Timestamp(DateTime.Now) .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .Build();
-
Add…メソッドは値を蓄積するため、呼び出す順序を考慮する必要があります。
例えば、以下のリクエストには2つのカスタム値が含まれます:
UTRequestBuilder.EventWithDefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .AddCustomValues("key1", "value1") .AddCustomValues("key2", "value2") .Build();
-
値を蓄積しないメソッドは一度だけ呼び出しるべきです。
正しい要求の例:
UTRequestBuilder.SearchEvent("some keywords") .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .Build();
InvalidOperationException例外を投げる誤ったリクエストの例:
UTRequestBuilder.SearchEvent("some keywords") .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .DefinitionId("01f8ffbf-d662-4a87-beee-413307055c48") .Timestamp(DateTime.Now) .Timestamp(DateTime.Now) .Build();