更新 bookingservice
命名空间：microsoft.graph
更新指定 bookingBusiness 中 bookingService 对象的属性。
下面是可为服务自定义的一些示例：
- 价格
- 约会的典型长度
- 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}。 必需。 |
请求正文
在请求正文中， 仅 提供要更新的属性的值。 请求正文中未包含的现有属性会保留其以前的值，或者根据对其他属性值的更改重新计算。
下表指定可更新的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| customQuestions | bookingQuestionAssignment 集合 | 这包含一组与特定服务关联的自定义问题。 可选。 |
| defaultDuration | 持续时间 | 服务的默认长度，以天、小时、分钟和秒数表示。 例如，P11D23H59M59.9999999999999S。 |
| defaultLocation | location | 服务的默认物理位置。 |
| defaultPrice | 双精度 | 服务的默认货币价格。 |
| defaultPriceType | bookingPriceType | 服务的默认收费方式。 可取值为：undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue。 |
| defaultReminders | bookingReminder 集合 | 此服务约会的默认提醒集。 仅当按 ID 读取此 bookingService 时，此属性的值才可用。 |
| 说明 | String | 服务的文本说明。 |
| displayName | String | 服务名称。 |
| id | String | bookingService 的唯一标识符。 此为只读属性。 |
| isAnonymousJoinEnabled | 布尔值 |
True 如果为此服务预订的约会生成匿名加入约会的 URL (anonymousJoinWebUrl) 。 |
| isCustomerAllowedToManageBooking | 布尔值 | 指示客户可以管理员工创建的预订。 默认值为 false。 |
| isHiddenFromCustomers | 布尔值 |
True 指示客户无法预订该服务。 |
| isLocationOnline | 布尔值 |
True 指示服务的约会联机举行。 默认值为 false。 |
| languageTag | String | 自助预订页面的语言。 |
| maximumAttendeesCount | Int32 | 服务中允许的最大客户数。 |
| notes | String | 有关此服务的其他信息。 |
| postBuffer | 持续时间 | 此服务的约会结束后以及下一次客户约会之前要缓冲的时间。 |
| preBuffer | 持续时间 | 此服务的约会开始前的缓冲时间。 |
| schedulingPolicy | bookingSchedulingPolicy | 确定应如何创建和管理此类服务的约会的策略集。 |
| smsNotificationsEnabled | 布尔值 |
True 指示可以向客户发送短信通知，以便预约服务。 默认值为 false。 |
| staffMemberIds | 字符串集合 | 表示提供此服务 的员工 。 |
响应
如果成功，此方法返回 204 No Content 响应代码。 它不会在响应正文中返回任何内容。
示例
请求
以下示例更新指定服务的持续时间。
PATCH https://graph.microsoft.com/v1.0/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