historyItem 资源类型

命名空间：microsoft.graph

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

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

方法

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

属性

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