activityHistoryItem 资源类型

命名空间：microsoft.graph

表示应用中 活动的 历史记录项。 用户活动表示应用中的单个目标;例如，电视节目、文档或视频游戏中的当前市场活动。 当用户参与该活动时，活动将捕获为指示该活动的开始和结束时间的历史记录项。 随着用户随着时间的推移重新参与该活动，单个用户活动将记录多个历史记录项。

当应用创建会话时，应将 activityHistoryItem 对象添加到 活动 对象，以反映用户参与期。 每次用户重新参与某个活动时，都会向活动添加新 activityHistoryItem 以累积用户参与度。

方法

方法	返回类型	说明
创建或替换历史记录项	activityHistoryItem	为该活动创建或替换现有 activityHistoryItem ， (upsert) 。 ID 必须是 GUID。
删除历史记录项	无内容	删除该 活动的指定 activityHistoryItem 。

属性

名称	类型	说明
activeDurationSeconds	int	可选。 活动用户参与的持续时间。 如果未提供，则从 startedDateTime 和 lastActiveDateTime 进行计算。
createdDateTime	DateTimeOffset	由服务器设置。 在服务器上创建对象的日期/时间（UTC）。
expirationDateTime	DateTimeOffset	可选。 活动HistoryItem 将进行硬删除的 UTC DateTime 时间。 可由客户端设置。
id	String	必填。 activityHistoryItem 对象的客户端设置 GUID。
lastActiveDateTime	DateTimeOffset	可选。 上次将 activityHistoryItem (活动会话) 理解为活动或已完成的 UTC DateTime - 如果为 null，则 activityHistoryItem 状态应为“正在进行”。
lastModifiedDateTime	DateTimeOffset	由服务器设置。 在服务器上修改对象时的 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"
}