状态资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

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

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

此资源支持订阅 更改通知。

方法

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

属性

属性	类型	说明
活动	字符串集合	用户可用性的补充信息。 可能的值为 Available、、Away、、BeRightBack、Busy、DoNotDisturbInAMeetingInactiveOfflineInACallInAConferenceCallOffWork、OutOfOffice、PresenceUnknown、 。 UrgentInterruptionsOnlyPresenting
availability	字符串集合	用户的基本状态信息。 可能的值为 Available、、AvailableIdle、Away、BusyIdleBusyDoNotDisturbBeRightBackOffline、 。 PresenceUnknown
id	String	用户的唯一标识符。
outOfOfficeSettings	outOfOfficeSettings	用户的外出设置。
statusMessage	presenceStatusMessage	用户的状态消息。

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

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

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