userActivity リソースの種類

名前空間: microsoft.graph

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

Microsoft Graph のアクティビティを使用すると、ユーザーが複数のデバイスにわたってアプリで実行していた操作に戻ることができるようになります。 アプリが作成したアクティビティは、すべてのユーザーのデバイスに表示され、アプリ内の特定のコンテンツへのディープ リンクとしてユーザーに表示されます。 アプリ内の特定のコンテンツを、Windows で表示される、または iOS および Android デバイスで Cortana 通知経由でアクセス可能な宛先として表現することができます。

すべてのアプリは異なるため、アプリケーション内のアクションを Cortana とタイムラインに表示されるユーザー アクティビティにマップする最適な方法を理解する必要があります。 たとえば、ゲームではキャンペーンごとにアクティビティが作成され、ドキュメント作成アプリでは固有のドキュメントごとにアクティビティが作成され、基幹業務アプリではワークフローごとにアクティビティが作成されます。

ユーザー アクティビティは、Cortana および Windows タイムラインのユーザー エクスペリエンスで表示されます。ユーザーが過去に作業したコンテンツに戻れるようにすることで、ユーザーの生産性と効率を向上させることに重点が置かれます。

メソッド

プロパティ

リレーションシップ

JSON 表記

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

{
    "appActivityId": "String",
    "activitySourceHost": "String (host name/domain/URL)",
    "userTimezone": "String",
    "appDisplayName": "String",
    "activationUrl": "String (URL)",
    "contentUrl": "String (URL)",
    "fallbackUrl": "String (URL)",
    "createdDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "expirationDateTime": "DateTimeOffset",
    "id": "String",
    "status": "string",
    "contentInfo": { "@data.type": "microsoft.graph.Json" },
    "visualElements": { "@data.type": "microsoft.graph.visualInfo" },
    "historyItems": [{ "@odata.type": "microsoft.graph.activityHistoryItem" }]
}