命名空间：microsoft.graph
包含有关用户状态的信息，包括其可用性和用户活动。
此资源支持订阅 更改通知。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取状态 | 状态 | 获取用户的状态信息。 |
| 获取多个用户的状态 | presence 集合 | 获取多个用户的状态信息。 |
| 设置状态 | 为用户设置应用程序的状态会话。 | |
| 清除状态 | 为用户清除应用程序的状态会话。 | |
| 设置用户首选状态 | 设置用户的首选可用性和活动状态。 | |
| 清除用户首选状态 | 清除用户的首选可用性和活动状态。 | |
| 设置用户状态消息 | 为用户设置状态消息。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 活动 | String | 用户可用性的补充信息。 可能的值为 available、、away、beRightBack、busyofflinedoNotDisturb、outOfOffice、 。 presenceUnknown |
| availability | String | 用户的基本状态信息。 可能的值为 available、、away、beRightBack、、busyinAMeetingdoNotDisturbinACallofflinefocusing、presenting、、 。 presenceUnknown |
| id | String | 用户的唯一标识符。 |
| outOfOfficeSettings | outOfOfficeSettings | 用户的外出设置。 |
| sequenceNumber | String | 可按词典排序的字符串标记，表示 状态 对象的版本。 |
| statusMessage | presenceStatusMessage | 用户的状态消息。 |
注意
- 若要了解有关不同状态的详细信息，请参阅 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"}
}