Тип ресурса bookingStaffMember
Пространство имен: 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. |
| Создание | коллекция bookingStaffMember | Создайте новый bookingStaffMember в указанном bookingBusiness. |
| Получение | 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)"
}