Тип ресурса bookingStaffMember

Статья
04/22/2024

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

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

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

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

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

Наследуется от bookingStaffMemberBase.

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 перед бронированием.
displayName	String	Имя сотрудника, отображаемое клиентам. Обязательно.
emailAddress	String	Адрес электронной почты сотрудника. Он может находиться в том же клиенте Microsoft 365, что и компания, или в другом домене электронной почты. Этот адрес электронной почты можно использовать, если для свойства sendConfirmationsToOwner задано значение true в политике планирования организации. Обязательный.
id	String	Идентификатор сотрудника в формате GUID. Только для чтения.
isEmailNotificationEnabled	Логический	`True` указывает, что сотрудник будет уведомлен по электронной почте при создании или изменении назначенного им резервирования.
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.

{
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}