Тип ресурса bookingStaffMember

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

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

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

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

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

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

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

Методы

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

Свойства

Свойство	Тип	Описание
availabilityIsAffectedByPersonalCalendar	Логический	Значение True означает, что если сотрудник является пользователем Microsoft 365, API Bookings проверяет доступность этого сотрудника в личном календаре в Microsoft 365 перед бронированием.
createdDateTime	DateTimeOffset	Дата, время и часовой пояс, когда сотрудник был создан. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
displayName	String	Имя сотрудника, отображаемое клиентам. Обязательно.
emailAddress	String	Адрес электронной почты сотрудника. Этот адрес электронной почты может находиться в том же клиенте Microsoft 365, что и компания, или в другом домене электронной почты. Этот адрес электронной почты можно использовать, если для свойства sendConfirmationsToOwner задано значение true в политике планирования организации. Обязательный.
id	String	Идентификатор сотрудника в формате GUID. Только для чтения.
isEmailNotificationEnabled	Логический	Указывает, что сотрудник получает уведомление по электронной почте при создании или изменении назначенного им резервирования. Значение по умолчанию — true.
membershipStatus	bookingStaffMembershipStatus	Статус членства сотрудника в бизнесе. Допустимые значения: active, pendingAcceptance, rejectedByStaff, unknownFutureValue.
lastUpdatedDateTime	DateTimeOffset	Дата, время и часовой пояс, когда сотрудник был обновлен в последний раз. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
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",
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "lastUpdatedDateTime": "String (timestamp)",
  "role": "String",
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}