更新 bookingstaffmember
命名空间:microsoft.graph
更新指定的bookingBusiness中的 bookingStaffMember的属性。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | Bookings.ReadWrite.All、Bookings.Manage.All |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用程序 | 不支持。 |
HTTP 请求
PATCH /bookingBusinesses/{id}/staffMembers/{id}
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | Bearer {code}。 必需。 |
请求正文
在请求正文中,仅 提供应更新的属性的值。未包含在请求正文中的现有属性将保留其以前的值或根据对其他属性值的更改重新计算。
下表指定可以更新的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| availabilityIsAffectedByPersonalCalendar | Boolean | True 表示如果员工是 Microsoft 365用户,Microsoft Bookings API 将使用 Microsoft 365 中的员工个人日历以及 workingHours 属性来确定可用性。 |
| displayName | String | 显示给客户的员工的姓名。 |
| emailAddress | String | 员工成员的电子邮件地址。 它可以与企业Microsoft 365租户中,也可以在不同的电子邮件域中。 如果在业务的计划策略中将 sendConfirmationsToOwner 属性设置为 ,则 true 使用此电子邮件地址。 |
| role | string | 员工在业务中的角色。 可取值为:guest、administrator、viewer、externalGuest。 |
| timeZone | 字符串 | 员工员工的时区。 有关可能值的列表,请参阅 dateTimeTimeZone。 |
| useBusinessHours | 布尔值 | True 表示员工的可用性由业务的业务 Hours 属性确定。 False 表示可用性由员工的 workingHouse 属性设置确定。 |
| workingHours | bookingWorkHours 集合 | 一周中每个员工可以预订的小时数范围。 |
响应
如果成功,此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。
示例
请求
以下示例将员工的计划更改为周一关闭。
PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/staffmembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json
{
"@odata.type":"#microsoft.graph.bookingStaffMember",
"workingHours":[
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"monday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"tuesday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"wednesday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"thursday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
},
{
"@odata.type":"#microsoft.graph.bookingWorkHours",
"day@odata.type":"#microsoft.graph.dayOfWeek",
"day":"friday",
"timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
"timeSlots":[
{
"@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
"endTime":"17:00:00.0000000",
"startTime":"08:00:00.0000000"
}
]
}
]
}
响应
下面展示了示例响应。
HTTP/1.1 204 No Content
反馈
提交和查看相关反馈