命名空间：microsoft.graph
包含有关用户状态的信息，包括用户状态和用户活动。
此资源支持订阅 更改通知。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取状态 | 状态 | 获取用户的状态信息。 |
| 获取多个用户的状态 | 状态 集合 | 获取多个用户的状态信息。 |
| 设置状态 | 为用户设置应用程序的状态会话。 | |
| 清除状态 | 为用户清除应用程序的状态会话。 | |
| 设置用户首选状态 | 设置用户的首选可用性和活动状态。 | |
| 清除用户首选状态 | 清除用户的首选可用性和活动状态。 | |
| 设置用户状态消息 | 为用户设置当前状态消息。 | |
| 设置自动位置 | 无 | 更新 用户的自动工作位置。 |
| 设置手动位置 | 无 | 为 用户设置手动工作位置信号。 |
| 清除自动位置 | 无 | 清除 用户的自动工作位置信号。 |
| 清除位置 | 无 | 清除 用户的工作位置信号，包括当前日期的手动图层和自动图层。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 活动 | String | 用户可用性的补充信息。 可能的值为 Available、 、 AwayBeRightBack、 DoNotDisturbBusyOfflineOutOfOfficePresenceUnknown。 |
| availability | String | 用户的基本状态信息。 可能的值为 Available、 AwayBeRightBackBusyDoNotDisturbFocusingInACallInAMeetingOfflinePresentingPresenceUnknown |
| 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" }
}