Actualizar bookingstaffmember

Espacio de nombres: microsoft.graph

Actualice las propiedades de un bookingStaffMember en el bookingBusiness especificado.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Bookings.ReadWrite.All	Bookings.Manage.All
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Bookings.ReadWrite.All	Bookings.Manage.All

Solicitud HTTP

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

Encabezados de solicitud

Nombre	Descripción
Autorización	{code} del portador. Necesario.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad	Tipo	Descripción
availabilityIsAffectedByPersonalCalendar	Booleano	True significa que si el miembro del personal es un usuario de Microsoft 365, la API de Microsoft Bookings usa el calendario personal del miembro del personal en Microsoft 365, así como la propiedad workingHours para determinar la disponibilidad.
displayName	Cadena	Nombre del miembro del personal, tal como se muestra a los clientes.
emailAddress	Cadena	Dirección de correo electrónico del miembro del personal. Puede estar en el mismo inquilino de Microsoft 365 que la empresa o en un dominio de correo electrónico diferente. Esta dirección de correo electrónico se usa si la propiedad sendConfirmationsToOwner está establecida true en en la directiva de programación de la empresa.
isEmailNotificationEnabled	Booleano	True indica que un miembro del personal recibirá una notificación por correo electrónico cuando se cree o cambie una reserva asignada a ellos.
role	bookingStaffRole	El rol del miembro del personal en la empresa. Valores posibles: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember.
timeZone	String	Zona horaria del miembro del personal. Para obtener una lista de los valores posibles, vea dateTimeTimeZone.
useBusinessHours	Booleano	True significa que la disponibilidad del miembro del personal viene determinada por la propiedad businessHours de la empresa. False significa que la disponibilidad viene determinada por la configuración de la propiedad workingHouse del miembro del personal.
workingHours	colección bookingWorkHours	El intervalo de horas cada día de la semana que el miembro del personal está disponible para reservar.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se cambia la programación del miembro del personal para que tenga los lunes desactivados.

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"
                }
            ]
        }
    ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content