Обновление bookingstaffmember

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

Обновите свойства bookingStaffMember в указанном bookingBusiness.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	Bookings.ReadWrite.All	Bookings.Manage.All
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	Bookings.ReadWrite.All	Bookings.Manage.All

HTTP-запрос

PATCH /solutions/bookingBusinesses/{id}/staffMembers/{id}

Заголовки запросов

Имя	Описание
Авторизация	Bearer {код}. Обязательно.

Текст запроса

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

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

Свойство	Тип	Описание
availabilityIsAffectedByPersonalCalendar	Логический	Значение True означает, что если сотрудник является пользователем Microsoft 365, API Microsoft Bookings использует личный календарь сотрудника в Microsoft 365, а также свойство workingHours для определения доступности.
displayName	String	Имя сотрудника, отображаемое клиентам.
emailAddress	String	Адрес электронной почты сотрудника. Он может находиться в том же клиенте Microsoft 365, что и компания, или в другом домене электронной почты. Этот адрес электронной почты используется, если свойству sendConfirmationsToOwner присвоено значение true в политике планирования организации.
isEmailNotificationEnabled	Логический	True указывает, что сотрудник будет уведомлен по электронной почте при создании или изменении назначенного им резервирования.
role	bookingStaffRole	Роль сотрудника в бизнесе. Возможные значения: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember.
timeZone	String	Часовой пояс сотрудника. Список возможных значений см. в разделе dateTimeTimeZone.
useBusinessHours	Логический	Значение True означает, что доступность сотрудника определяется свойством businessHours компании. Значение False означает, что доступность определяется параметром свойства workingHouse сотрудника.
workingHours	коллекция bookingWorkHours	Диапазон часов каждый день недели, в течение которых сотрудник может забронировать.

Отклик

В случае успешного выполнения этот метод возвращает код отклика 204 No Content. Он не возвращает ничего в теле ответа.

Пример

Запрос

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

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/staffMembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingStaffMember",
    "workingHours":[
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"monday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[

            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"tuesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "endTime":"17:00:00.0000000",
                    "startTime":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"wednesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "endTime":"17:00:00.0000000",
                    "startTime":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"thursday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "endTime":"17:00:00.0000000",
                    "startTime":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"friday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "endTime":"17:00:00.0000000",
                    "startTime":"08:00:00.0000000"
                }
            ]
        }
    ]
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content