命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示工作计划中特定日期或时间段的特定工作计划实例。
你的工作计划事件可以从定期工作模式自动生成，也可以为特殊安排手动创建。 这些事件对于处理常规计划的异常非常有用。 以下列表显示了示例：
- 在特定日期的不同工作时间
- 从其他位置工作
- 休假
如果某个工作计划与定期模式在同一时间段内存在，则优先执行，从而可以灵活调整计划。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | workPlanOccurrence | 在自己的工作计划中创建新的 workPlanOccurrence 对象。 |
| 更新 | workPlanOccurrence | 更新自己的 工作计划中 workPlanOccurrence 对象的属性。 |
| 删除 | 无 | 从自己的 工作计划中删除 workPlanOccurrence 对象。 |
| 设置当前位置 | 无 | 更新当前日期或当前活动段 的工作 位置。 |
| “事件”视图 | workPlanOccurrence 集合 | 从自己的工作计划中获取指定日期范围内的工作计划 事件 。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| end | dateTimeTimeZone | 此事件的结束日期和时间。 |
| id | String | 匹配项的唯一标识符。 |
| placeId | String | Microsoft Graph Places Directory API 中某个位置的标识符。 仅当 workLocationType 设置为 office时适用。 |
| recurrenceId | String | 生成此事件的父重复模式的标识符。 值用于 null 超时事件，因为它们没有父重复周期。 |
| start | dateTimeTimeZone | 此事件的开始日期和时间。 |
| timeOffDetails | timeOffDetails | 有关休假的详细信息。 仅当 workLocationType 设置为 timeOff时适用。 |
| workLocationType | workLocationType | 工作地点的类型。 可能的值包括 unspecified、office、remote、timeOff、unknownFutureValue。 |
workLocationType 值
| 成员 | 说明 |
|---|---|
| 未指定 | 指示用户未指定位置。 |
| 办公室 | 指示用户从办公室位置工作。 |
| 远程 | 指示用户远程工作。 |
| timeOff | 指示用户正在休假。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"id": "String (identifier)",
"placeId": "String",
"recurrenceId": "String",
"start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"timeOffDetails": {"@odata.type": "microsoft.graph.timeOffDetails"},
"workLocationType": "String"
}