使用 Microsoft Graph 中的Microsoft Bookings API 进行共享预订

Microsoft Bookings允许企业组织和小企业主以最少的设置来管理共享预订中的客户预订和信息。 企业所有者可以创建一个或多个企业，每个企业都提供一组服务。 所有者可以设置员工，并指定每名员工执行的服务。 客户可以通过在线或移动应用预约该企业中的特定服务。 Microsoft Bookings可确保有关业务、员工和客户的约会时间保持最新。

重要

Microsoft Graph 中的Microsoft Bookings API 仅适用于共享预订。 API 不适用于个人预订。

就编程而言，Bookings API 中的 bookingBusiness 涉及以下对象：

• 一个或多个 bookingStaffMember 对象
• 一个或多个 bookingService 对象
• 一组 bookingAppointment 实例
• 一组 bookingCustomer 对象

使用 Microsoft Bookings REST API

第一次客户预约之前，请完成以下步骤。 确保为相应的操作提供适当的访问令牌。

1. 确保企业具有 Microsoft 365 商业高级版订阅。
2. 通过向实体集发送 POST 操作来创建新的 bookingBusiness。 至少应为新企业指定客户将看到的名称：

POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

使用 POST 响应中返回的新 bookingBusiness 的 id 属性继续自定义企业设置，并为企业添加员工和服务。

3. 为企业添加各个员工：

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"
}

4. 定义企业提供的每项服务：

POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}

5. 发布企业的日程安排页面，让客户和企业经营者开始预约：

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 的方法

相关内容

• 尝试在 Graph 浏览器中调用 API。
• 了解如何在 Microsoft Graph 中选择权限。