状态资源类型

命名空间：microsoft.graph

重要

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

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

注意： 此资源当前仅受Microsoft Teams支持。

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

Methods

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

属性

属性	类型	说明
id	string	用户对象 ID
availability	字符串集合	用户的基本状态信息。 可能的值为 、、Available``AvailableIdle、Away、BeRightBack、Busy、BusyIdle、DoNotDisturb、Offline、PresenceUnknown
活动	string collection	用户可用性的补充信息。 可能的值是 、Away、Available、BeRightBack、Busy、DoNotDisturb、InACall、、InAMeeting``InAConferenceCall``OutOfOffice``Inactive``Presenting``Offline``PresenceUnknown``OffWork``UrgentInterruptionsOnly 。
outOfOfficeSettings	outOfOfficeSettings	用户的外出设置。

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

关系

无。

JSON 表示形式

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

{
   "id":"string",
   "availability":"string",
   "activity":"string",
   "outOfOfficeSettings":{"@odata.type": "#microsoft.graph.outOfOfficeSettings"}
}