大网数据广告活动
Microsoft Graph 接口

使用 Microsoft Graph 中的 Microsoft Bookings API

· 52CE 我爱测

Microsoft Bookings 可让企业组织和小型企业所有者以最少量的设置管理客户预订和信息。

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

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

使用 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 属性继续 自定义企业设置,并为企业添加员工和服务。

  1. 为企业添加各个员工:
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"
}
  1. 定义企业提供的每项服务:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. 发布企业的日程安排页面,让客户和企业经营者开始预约:
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 集的最新功能和更新。

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 arvindmicrosoft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。