Тип ресурса bookingStaffMember

Статья
04/18/2024

Пространство имен: microsoft.graph

Важно!

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

Представляет сотрудника, который предоставляет услуги в bookingBusiness.

Сотрудники могут быть частью клиента Microsoft 365, в котором настроен бизнес по бронированию, или использовать службы электронной почты от других поставщиков услуг электронной почты.

При бронировании встреч API Bookings учитывает следующие параметры для определения доступности сотрудника:

По умолчанию часы работы компании (свойство businessHours сущности bookingBusiness ) представляют собой общую доступность сотрудника.
Если параметр useBusinessHours имеет значение false, то конкретные рабочие часы сотрудника (свойство workHours объекта bookingStaffmember ) представляют общую доступность этого участника.
Если значение availabilityIsAffectedByPersonalCalendar имеет значение true, API Bookings сначала просматривает общедоступные часы сотрудника (как определено в no 1 или No 2) и проверяет доступность в течение этих часов в личном календаре сотрудника перед бронированием.

Microsoft Bookings поддерживает не более 100 сотрудников в календаре бронирования.

Методы

Метод	Возвращаемый тип	Описание
Перечисление сотрудников	коллекция bookingStaffMember	Получите список объектов bookingStaffMember в указанном bookingBusiness.
Создание bookingStaff	коллекция bookingStaffMember	Создайте новый bookingStaffMember в указанном bookingBusiness.
Получить bookingStaffMember	bookingStaffMember	Получите свойства и связи bookingStaffMember в указанном bookingBusiness.
Обновление	Нет	Обновите свойства bookingStaffMember в указанном bookingBusiness.
удаление;	Нет	Удалите сотрудника в указанном bookingBusiness.

Свойства

Свойство	Тип	Описание
availabilityIsAffectedByPersonalCalendar	Логический	Значение True означает, что если сотрудник является пользователем Microsoft 365, API Bookings проверяет доступность этого сотрудника в личном календаре в Microsoft 365 перед бронированием.
colorIndex	Int32	Определяет цвет, представляющий сотрудника. Цвет соответствует цветовой палитре на странице Сведения о персонале в приложении Bookings.
createdDateTime	DateTimeOffset	Дата, время и часовой пояс, когда сотрудник был создан.
displayName	String	Имя сотрудника, отображаемое клиентам. Обязательно.
emailAddress	String	Адрес электронной почты сотрудника. Этот адрес электронной почты может находиться в том же клиенте Microsoft 365, что и компания, или в другом домене электронной почты. Этот адрес электронной почты можно использовать, если для свойства sendConfirmationsToOwner задано значение true в политике планирования организации. Обязательный.
id	String	Идентификатор сотрудника в формате GUID. Только для чтения.
isEmailNotificationEnabled	Логический	Указывает, что сотрудники получают уведомления по электронной почте при создании или изменении назначенного им резервирования. Значение по умолчанию — `true`
lastUpdatedDateTime	DateTimeOffset	Дата, время и часовой пояс последнего обновления сотрудника.
role	bookingStaffRole	Роль сотрудника в бизнесе. Возможные значения: `guest`, `administrator`, `viewer`, `externalGuest`, `unknownFutureValue`, `scheduler`, `teamMember`. Необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: `scheduler`, `teamMember`. Обязательно.
timeZone	String	Часовой пояс сотрудника. Список возможных значений см. в разделе dateTimeTimeZone.
useBusinessHours	Логический	Значение True означает, что доступность сотрудника указана в свойстве businessHours компании. Значение false означает, что доступность определяется параметром свойства workingHours сотрудника.
workingHours	коллекция bookingWorkHours	Диапазон часов каждый день недели, в течение которых сотрудник может забронировать. По умолчанию они инициализированы таким же образом, что и свойство businessHours .

Связи

Нет

Представление JSON

Следующий код JSON представляет ресурс.

{
  "@odata.type": "#microsoft.graph.bookingStaffMember",
  "id": "String (identifier)",
  "displayName": "String",
  "emailAddress": "String",
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "colorIndex": "Integer",
  "role": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [
    {
      "@odata.type": "microsoft.graph.bookingWorkHours"
    }
  ],
  "timeZone": "String",
  "isEmailNotificationEnabled": "Boolean",
  "createdDateTime": "String (timestamp)",
  "lastUpdatedDateTime": "String (timestamp)"
}