更新 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 | 服务收费的默认方式。 可取值为:undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue。 |
| 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
反馈
提交和查看相关反馈