命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
包含有关用户状态的信息，包括其可用性和用户活动。
此资源支持订阅 更改通知。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取状态 | 状态 | 获取用户的状态信息。 |
| 获取多个用户的状态 | presence 集合 | 获取多个用户的状态信息。 |
| 设置状态 | 为用户设置应用程序 状态会话 中的可用性和活动状态。 | |
| 清除状态 | 为用户清除应用程序的状态会话。 | |
| 设置用户首选状态 | 设置用户的首选可用性和活动状态。 | |
| 清除用户首选状态 | 清除用户的首选可用性和活动状态。 | |
| 设置用户状态消息 | 为用户设置状态消息。 | |
| 设置自动位置 | 无 | 更新 用户的自动工作位置。 |
| 设置手动位置 | 无 | 为 用户设置手动工作位置信号。 |
| 清除自动位置 | 无 | 清除 用户的自动工作位置信号。 |
| 清除位置 | 无 | 清除 用户的工作位置信号，包括当前日期的手动层和自动层。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 活动 | String | 用户可用性的补充信息。 可能的值为 available、、away、beRightBack、busyofflinedoNotDisturb、outOfOffice、 。 presenceUnknown |
| availability | String | 用户的基本状态信息。 可能的值为 available、、away、beRightBack、、busyinAMeetingdoNotDisturbinACallofflinefocusing、presenting、、 。 presenceUnknown |
| id | String | 用户的唯一标识符。 |
| outOfOfficeSettings | outOfOfficeSettings | 用户的外出设置。 |
| sequenceNumber | String | 可按词典排序的字符串标记，表示 状态 对象的版本。 |
| statusMessage | presenceStatusMessage | 用户的状态消息。 |
| workLocation | userWorkLocation | 表示用户的聚合工作位置状态。 |
注意
- 若要了解有关不同状态的详细信息，请参阅 Teams 中的用户状态。
- 有关状态会话、状态排列、超时和受信任域的详细信息，请参阅使用Microsoft图形 API管理状态。
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"activity": "String",
"availability": "String",
"id": "String (identifier)",
"outOfOfficeSettings": {"@odata.type": "#microsoft.graph.outOfOfficeSettings"},
"sequenceNumber": "String",
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"},
"workLocation": {"@odata.type": "microsoft.graph.userWorkLocation" }
}