Поделиться через

Использование API Microsoft Bookings в Microsoft Graph для общих резервирований

  • Статья

Microsoft Bookings позволяет организациям и владельцам малого бизнеса управлять резервированием клиентов и информацией в общих резервированиях с минимальной настройкой. Владелец бизнеса можно создать одну или несколько компаний, каждая из которых предлагает набор услуг. Владелец может настроить сотрудников и указать услуги, оказываемые каждым из них. Клиент может зарезервировать встречу для определенной услуги в этой компании в сетевом или мобильном приложении. Microsoft Bookings гарантирует, что время встречи будет оставаться в актуальном состоянии для бизнеса, сотрудников и клиентов, участвующих в ней.

Важно!

API Microsoft Bookings в Microsoft Graph применяется только к общим резервированиям. API не применяется для личных резервирований.

На программном уровне объект bookingBusiness в API Bookings включает указанные ниже объекты:

Использование REST API Microsoft Bookings

Выполните указанные ниже действия перед первым резервированием встреч клиента с компанией. Убедитесь, что предоставлены подходящие маркеры доступа для соответствующих операций.

  1. Убедитесь, что у компании есть подписка на Microsoft 365 бизнес премиум.
  2. Создайте новый объект bookingBusiness, отправив операцию POST в набор объектов. Как минимум, следует указать имя новой компании, отображаемое для клиентов:
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

Используйте свойство id нового объекта bookingBusiness, возвращенного в отклике POST, чтобы продолжить настройку бизнес-параметров и добавить сотрудников и услуги для компании.

  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}

Основные варианты использования

В таблице ниже перечислены распространенные операции для бизнеса в API Bookings.

Варианты использования Ресурсы REST См. также
Создание, получение, обновление или удаление компании bookingBusiness Методы ресурса bookingBusiness
Обновление политики планирования bookingSchedulingPolicy Обновление bookingBusiness
Добавление, получение, обновление или удаление сотрудников bookingStaffMember Методы ресурса bookingStaffMember
Добавление, получение, обновление или удаление услуг bookingService Методы ресурса bookingService
Добавление, получение, обновление или удаление настраиваемых вопросов bookingCustomQuestion Методы bookingCustomQuestion
Добавление, получение, обновление или удаление пользователей bookingCustomer Методы bookingCustomer
Публикация или отмена публикации страницы расписания bookingBusiness publish
unpublish
Создание, получение, обновление, удаление или отмена встречи bookingAppointment Методы ресурса bookingAppointment
Получение встреч в диапазоне дат bookingBusiness Представление календаря "Список резервирований"
Получение валюты bookingCurrency Методы ресурса bookingCurrency

Связанные материалы