反馈 编辑

更新 bookingstaffmember

  • 项目

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

更新指定 bookingBusiness 中 bookingStaffMember 的属性。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Bookings.ReadWrite.All、Bookings.Manage.All
委派（个人 Microsoft 帐户） 不支持。
Application 不支持。

HTTP 请求

PATCH /bookingBusinesses/{id}/staffMembers/{id}

可选的请求标头

名称 说明
Authorization 持有者 {code}。必需。

请求正文

在请求正文中，提供应更新的相关字段的值。 请求正文中不包括的现有属性将保留其以前的值，或根据对其他属性值的更改重新计算。 为了获得最佳性能，请勿加入尚未更改的现有值。

属性 类型 Description
availabilityIsAffectedByPersonalCalendar 布尔 True 表示如果员工是Microsoft 365用户，则 Bookings API 使用员工在 Microsoft 365 中的个人日历以及 workingHours 属性来确定可用性。
colorIndex Int32 标识表示工作人员的颜色。 颜色对应于 Bookings 应用中 “员工详细信息 ”页中的调色板。
displayName String 向客户显示的工作人员的名称。
emailAddress String 工作人员的电子邮件地址。 这可以位于与企业相同的Microsoft 365租户中，也可以位于其他电子邮件域中。 如果在业务的计划策略中 将 sendConfirmationsToOwner 属性设置为 true，则使用此电子邮件地址。
isEmailNotificationEnabled 布尔 True 表示在创建或更改分配给他们的预订时，员工将通过电子邮件收到通知。
role string 员工在业务中的角色。 可取值为：guest、administrator、viewer、scheduler、member、externalGuest。
timeZone String 工作人员的时区。 有关可能值的列表，请参阅 dateTimeTimeZone。
useBusinessHours 布尔 True 表示员工的可用性由企业的 businessHours 属性决定。 False 表示可用性由员工 的工作屋 属性设置决定。
workingHours bookingWorkHours 集合 工作人员可预订的一周中每天的小时数范围。

响应

如果成功，此方法返回 204 No content 响应代码。它不在响应正文中返回任何内容。

示例

请求

以下示例将工作人员的计划更改为星期一休息。

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/staffmembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json

{
    "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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        }
    ]
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content