状态资源类型

命名空间:microsoft.graph

包含有关用户状态的信息,包括其可用性和用户活动。

注意: 此资源目前仅支持 Microsoft Teams 用户。

此资源支持订阅 更改通知

方法

方法 返回类型 说明
获取状态 状态 获取用户的状态信息。
获取多个用户的状态 presence 集合 获取多个用户的状态信息。
设置状态 为用户设置应用程序的状态会话。
清除状态 为用户清除应用程序的状态会话。
设置用户首选状态 设置用户的首选可用性和活动状态。
清除用户首选状态 清除用户的首选可用性和活动状态。
设置用户状态消息 为用户设置状态消息。

属性

属性 类型 说明
活动 字符串集合 用户可用性的补充信息。 可能的值为 Available、、Away、、BeRightBackBusyDoNotDisturbInAMeetingInactiveOfflineInACallInAConferenceCallOffWorkOutOfOfficePresenceUnknown、 。 UrgentInterruptionsOnlyPresenting
availability 字符串集合 用户的基本状态信息。 可能的值为 Available、、AvailableIdleAwayBusyIdleDoNotDisturbBeRightBackBusy、、 OfflinePresenceUnknown
id String 用户的唯一标识符。
statusMessage presenceStatusMessage 用户的状态消息。

注意: 若要了解有关不同状态的详细信息,请参阅 Teams 中的用户状态

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
   "activity": "String",
   "availability":"String",
   "id": "String (identifier)",
   "statusMessage":{"@odata.type": "#microsoft.graph.presenceStatusMessage"}
}