次の方法で共有


activityHistoryItem リソースの種類

名前空間: microsoft.graph

アプリ内の アクティビティ の履歴アイテムを表します。 ユーザー アクティビティは、アプリ内の 1 つの宛先を表します。たとえば、テレビ番組、ドキュメント、ビデオ ゲームの現在のキャンペーンなどです。 ユーザーがそのアクティビティに関与すると、そのアクティビティの開始時刻と終了時刻を示す履歴アイテムとしてエンゲージメントがキャプチャされます。 ユーザーが時間の経過と共にそのアクティビティに再び関与すると、1 つのユーザー アクティビティに対して複数の履歴項目が記録されます。

アプリがセッションを作成する場合、ユーザー エンゲージメントの期間を反映するために activityHistoryItem オブジェクトを アクティビティ オブジェクトに追加する必要があります。 ユーザーがアクティビティに再参加するたびに、新しい activityHistoryItem がアクティビティに追加され、ユーザー エンゲージメントが発生します。

メソッド

メソッド 戻り値の型 説明
履歴項目を作成または置換する activityHistoryItem そのアクティビティの既存の アクティビティHistoryItem を作成または置き換えます (アップサート)。 ID は GUID である必要があります。
履歴項目を削除する コンテンツはありません 指定したアクティビティを削除します。そのアクティビティの HistoryItem

プロパティ

名前 説明
activeDurationSeconds int 省略可能。 アクティブなユーザー エンゲージメントの期間。 指定されていない場合、これは startedDateTimelastActiveDateTime から計算されます。
createdDateTime DateTimeOffset サーバーによって設定されます。 オブジェクトがサーバー上に作成されたときの DATETime (UTC)。
expirationDateTime DateTimeOffset 省略可能。 アクティビティHistoryItem がハード削除される UTC DateTime。 クライアントで設定できます。
id String 必須です。 activityHistoryItem オブジェクトのクライアント セット GUID。
lastActiveDateTime DateTimeOffset 省略可能。 アクティビティHistoryItem (アクティビティ セッション) が最後にアクティブまたは完了と認識された場合の UTC DateTime - null の場合、activityHistoryItem の状態は [進行中] である必要があります。
lastModifiedDateTime DateTimeOffset サーバーによって設定されます。 オブジェクトがサーバー上で変更されたときの DATETime (UTC)。
startedDateTime DateTimeOffset 必須です。 activityHistoryItem (アクティビティ セッション) が開始された UTC DateTime。 タイムラインの履歴に必要です。
status status サーバーによって設定されます。 有効なオブジェクトを識別するために使用される状態コード。 値: アクティブ、更新、削除、無視。
userTimezone String 省略可能。 アクティビティの生成に使用されたユーザーのデバイスがアクティビティの作成時に配置されたタイム ゾーン。 クロスプラットフォーム表現をサポートするために Olson ID として指定された値。

リレーションシップ

リレーションシップ 説明
アクティビティ userActivity 省略可能。 NavigationProperty/Containment;ナビゲーション プロパティを関連付けられたアクティビティに移動します。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
    "activeDurationSeconds":"int",
    "createdDateTime": "DateTimeOffset",
    "expirationDateTime": "DateTimeOffset",
    "id": "String",
    "lastActiveDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "startedDateTime": "DateTimeOffset",
    "status": "String",
    "userTimezone": "String"
}