命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示新式混合工作方案的工作时间和位置首选项。
在涉及活动规划、资源分配和会议安排的方案中，访问工作时间和位置信息非常有用。 你可以 获取 和 更新 工作时间和位置，作为个人工作规划的一部分。
可以设置不同的工作位置和计划，以适应灵活的工作安排。 这些设置对于混合工作场景非常有用，在这些方案中，你可能会在办公室工作几天，而远程工作。 可以为常规计划设置定期模式，并为异常或特殊安排创建特定事件。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| Get | workHoursAndLocationsSetting | 获取自己的 workHoursAndLocationsSetting 的属性和关系。 |
| 更新 | workHoursAndLocationsSetting | 更新自己的 workHoursAndLocationsSetting 的属性。 |
| “事件”视图 | workPlanOccurrence 集合 | 从自己的工作计划中获取指定日期范围内的工作计划 事件 。 |
| 列出重复周期 | workPlanRecurrence 集合 | 通过 重复周期 导航属性从你自己的工作计划 中获取重复周期 。 |
| 创建重复周期 | workPlanRecurrence | 在自己的工作计划中创建新的 workPlanRecurrence 对象。 |
| 创建匹配项 | workPlanOccurrence | 在自己的工作计划中创建新的 workPlanOccurrence 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| maxSharedWorkLocationDetails | maxWorkLocationDetails | 控制可与同事共享的工作地点详细信息级别。 可能的值包括 unknown、none、approximate、specific、unknownFutureValue。 |
maxWorkLocationDetails 值
| 成员 | 说明 |
|---|---|
| unknown | 要共享的位置详细信息级别未知。 |
| 无 | 不共享位置详细信息。 |
| 近似 | 仅共享常规工作位置类型，例如办公室或远程。 |
| 特定 | 共享详细的位置信息，例如建筑物和桌面信息。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 复发 | workPlanRecurrence 集合 | 用户定义的定期工作计划的集合。 |
| 事件 | workPlanOccurrence 集合 | 工作计划事件集合。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"maxSharedWorkLocationDetails": "String"
}