更新 bookingservice

命名空间:microsoft.graph

更新指定的 bookingBusiness 中的 bookingService对象的属性。

以下是您可以为服务自定义的一些示例:

  • 价格
  • 约会的典型长度
  • Reminders
  • 在服务之前或之后完成设置的任何时间缓冲区
  • 计划策略 参数,例如预订或取消的最低通知,以及客户是否可以选择特定员工进行约会。

权限

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

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Bookings.ReadWrite.All、Bookings.Manage.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 不支持。

HTTP 请求

PATCH /bookingBusinesses/{id}/services/{id}

请求标头

名称 说明
Authorization Bearer {code}。 必需。

请求正文

在请求正文中, 提供应更新的属性的值。未包含在请求正文中的现有属性将保留其以前的值或根据对其他属性值的更改重新计算。

下表指定可以更新的属性。

属性 类型 说明
customQuestions bookingQuestionAssignment 集合 这包含一组与特定服务关联的自定义问题。 可选。
defaultDuration 期限 服务的默认长度,以天数、小时数、分钟数和秒数表示。 例如,P11D23H59M59.9999999999S。
defaultLocation location 服务的默认物理位置。
defaultPrice 双精度 服务的默认货币价格。
defaultPriceType bookingPriceType 服务收费的默认方式。 可取值为:undefinedfixedPricestartingAthourlyfreepriceVariescallUsnotSetunknownFutureValue
defaultReminders bookingReminder 集合 此服务约会的默认提醒集。 此属性的值仅在按其 ID 读取此 bookingService 时可用。
description String 服务的文本说明。
displayName String 服务名称。
id String bookingService 的唯一标识符。 只读。
isHiddenFromCustomers 布尔值 如果 true 为 ,则客户无法预订该服务。
isLocationOnline 布尔值 如果 true 指示服务约会将联机进行。 默认值为 false
maximumAttendeesCount Int32 服务中允许的最大客户数。
notes String 有关此服务的其他信息。
postBuffer 期限 此服务的约会结束后以及下一个客户约会可以预订之前进行缓冲的时间。
preBuffer 期限 在此服务的约会可以启动之前缓冲的时间。
schedulingPolicy bookingSchedulingPolicy 用于确定如何创建和管理这种类型的服务的约会的策略集。
smsNotificationsEnabled Boolean 如果为 True,则表明可以针对服务约会将短信通知发送给客户。 默认值为 false。
staffMemberIds String collection 表示 提供此服务 的员工。

响应

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

示例

请求

以下示例更新指定服务的持续时间。

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingService",
    "defaultDuration":"PT30M"
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content