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

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

  • Статья

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Важно!

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

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

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

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

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

{
    "displayName":"Contoso"
}

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

  1. Добавьте отдельных сотрудников для компании:
POST https://graph.microsoft.com/beta/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/beta/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. Опубликуйте страницу расписания для компании, чтобы у клиентов и бизнес-операторов была возможность начать резервирование встреч:
POST https://graph.microsoft.com/beta/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

Как правило, можно указать список всех компаний для резервирования в клиенте Microsoft 365:

GET https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token}

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

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

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

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