替换 timeOff
命名空间:microsoft.graph
替换现有的 timeOff 对象。
如果指定的 timeOff 对象不存在,则此方法返回 404 Not found
。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Group.Read.All | Schedule.ReadWrite.All、Group.ReadWrite.All |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Schedule.ReadWrite.All | 不可用。 |
注意:此 API 支持管理员权限。 具有管理员角色的用户可以访问他们不是其成员的组。
HTTP 请求
PUT /teams/{teamId}/schedule/timesOff/{timeOffId}
请求标头
标头 | 值 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
Content-Type | application/json. 必需。 |
MS-APP-ACTS-AS | GUID) (用户 ID。 仅当授权令牌是应用程序令牌时才需要;否则为可选。 |
请求正文
在请求正文中, 仅 提供要更新的属性的值。 请求正文中未包含的现有属性会保留其以前的值,或者根据对其他属性值的更改重新计算。
下表指定可更新的属性。
属性 | 类型 | 说明 |
---|---|---|
draftTimeOff | timeOffItem | 此 timeOff 项的草稿版本,可由经理查看。 必须先共享它,然后才能对团队成员可见。
draftOpenShift 或 sharedOpenShift 应为 null 。 |
isStagedForDeletion | 布尔值 | timeOff 标记为要删除,这是共享计划时完成的过程。 可选 |
sharedTimeOff | timeOffItem | 此 timeOff 的共享版本,可由员工和经理查看。 汇报 sharedTimeOff 属性向 Teams 客户端中的用户发送通知。
draftOpenShift 或 sharedOpenShift 应为 null 。 |
userId | String | 分配给 timeOff 的用户的 ID。 必填。 |
响应
如果成功,此方法将 204 No Content
返回响应代码和空内容。 如果请求指定具有return=representation
首选项的Prefer
标头,则此方法在响应正文中返回200 OK
响应代码和 timeOff 对象。
示例
请求
以下示例显示了一个请求。
PUT https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/timesOff/{timeOffId}
Content-type: application/json
{
"userId": "aa162a04-bec6-4b81-ba99-96caa7b2b24d",
"sharedTimeOff": {
"timeOffReasonId": "TOR_29a5ba96-c7ef-4e76-bec6-055323746314",
"startDateTime": "2024-10-10T19:00:00Z",
"endDateTime": "2024-10-10T20:00:00Z",
"theme": "blue"
},
"draftTimeOff": null
}
响应
以下示例显示了相应的响应。
HTTP/1.1 204 No Content