Microsoft Bookings 可让企业组织和小型企业所有者以最少量的设置管理客户预订和信息。 企业所有者可以创建一个或多个企业,每个企业都提供一组服务。 所有者可以设置员工,并指定每名员工执行的服务。 客户可以通过在线或移动应用预约该企业中的特定服务。 Bookings 可确保为企业、员工和相关客户保持最新的约会时间。
就编程而言,Bookings API 中的 bookingBusiness 涉及以下对象:
- 一个或多个 bookingStaffMember 对象
- 一个或多个 bookingService 对象
- 一组 bookingAppointment 实例
- 一组 bookingCustomer 对象
使用 Bookings REST API
第一次客户预约之前,请完成以下步骤。 确保为相应的操作提供适当的访问令牌。
- 确保企业具有 Microsoft 365 商业高级版订阅。
- 通过向实体集发送 POST 操作来创建新的 bookingBusiness。 至少应为新企业指定客户将看到的名称:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json
{
"displayName":"Contoso"
}
使用 POST 响应中返回的新 bookingBusiness 的 id 属性继续 自定义企业设置,并为企业添加员工和服务。
- 为企业添加各个员工:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/staffMembers
Authorization: Bearer {access token}
Content-Type: application/json
{
"displayName":"Dana Swope",
"emailAddress": "danas@contoso.com",
"role": "externalGuest"
}
- 定义企业提供的每项服务:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json
{
"displayName":"Bento"
}
- 发布企业的日程安排页面,让客户和企业经营者开始预约:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}
通常,若要列出 Microsoft 365 租户中的所有预订企业:
GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
常见用例
下表列出了 Bookings API 中的常见企业操作。
| 用例 | REST 资源 | 另请参阅 |
|---|---|---|
| 创建、获取、更新或删除企业 | bookingBusiness | bookingBusiness 的方法 |
| 更新日程安排策略 | bookingSchedulingPolicy | 更新 bookingBusiness |
| 添加、获取、更新或删除员工 | bookingStaffMember | bookingStaffMember 的方法 |
| 添加、获取、更新或删除服务 | bookingService | bookingService 的方法 |
| 添加、获取、更新或删除自定义问题 | bookingCustomQuestion | bookingCustomQuestion 的方法 |
| 添加、获取、更新或删除客户 | bookingCustomer | bookingCustomer 的方法 |
| 发布或取消发布日程安排页面 | bookingBusiness | 发布 取消发布 |
| 创建、获取、更新、删除或取消约会 | bookingAppointment | bookingAppointment 的方法 |
| 获取某个日期范围内的约会 | bookingBusiness | 列出 Bookings 日历视图 |
| 获取货币 | bookingCurrency | bookingCurrency 的方法 |
最近更新
了解此 API 集的最新功能和更新。
另请参阅
- 尝试 Graph 浏览器中的 API。
- 请参阅我们的一些合作伙伴如何使用 Microsoft Graph。
- 了解如何在 Microsoft Graph 中选择权限。
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 arvindmicrosoft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
