更新 bookingservice

命名空间:microsoft.graph

重要

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

更新指定 bookingBusinessbookingService 对象的属性。

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

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

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

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

HTTP 请求

PATCH /solutions/bookingbusinesses/{id}/services/{id}

可选的请求标头

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

请求正文

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

属性 类型 说明
defaultDuration 持续时间 服务的默认长度,以天、小时、分钟和秒数表示。 例如,P11D23H59M59.9999999999999S。
defaultLocation location 服务的默认物理位置。
defaultPrice 双精度 服务的默认货币价格。
defaultPriceType bookingPriceType 服务的默认收费方式。 可取值为:undefinedfixedPricestartingAthourlyfreepriceVariescallUsnotSetunknownFutureValue
defaultReminders bookingReminder 集合 此服务约会的默认提醒集。 仅当按 ID 读取此 bookingService 时,此属性的值才可用。
说明 String 服务的文本说明。
displayName String 服务名称。
id String 只读。
isAnonymousJoinEnabled 布尔值 True 如果为此服务预订的约会生成匿名加入约会的 URL (anonymousJoinWebUrl) 。
isCustomerAllowedToManageBooking 布尔值 指示客户可以管理员工创建的预订。 默认值为 false
isHiddenFromCustomers 布尔值 如果为 True,则表示此服务不可供客户预订。
isLocationOnline 布尔值 如果为 True,则表示该服务的约会处于联机状态。 默认值为 false
languageTag String 自助预订页面的语言。
notes String 有关此服务的其他信息。
postBuffer 持续时间 此服务的约会结束后以及下一次客户约会之前要缓冲的时间。
preBuffer 持续时间 此服务的约会开始前的缓冲时间。
schedulingPolicy bookingSchedulingPolicy 确定应如何创建和管理此类服务的约会的策略集。
smsNotificationsEnabled 布尔值 如果为 True,则表示可以向客户发送服务预约的短信通知。 默认值为 false
staffMemberIds 字符串集合 表示提供此服务 的员工
customQuestions bookingQuestionAssignment 集合 这包含与特定服务关联的一组自定义问题。 可选。
maximumAttendeesCount Int32 服务中允许的最大客户数。

响应

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

示例

请求

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

PATCH https://graph.microsoft.com/beta/solutions/bookingbusinesses/contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

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

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content