Actualizar bookingstaffmember

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en v1.0, use el selector de versiones.

Actualice las propiedades de un bookingStaffMember en el bookingbusinessespecificado.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Bookings. ReadWrite. All, Bookings. Manage. All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación No admitida.

Solicitud HTTP

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

Encabezados de solicitud opcionales

Nombre Descripción
Autorización Portador {código}

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento, no debe incluir valores existentes que no hayan cambiado.

Propiedad Tipo Description
availabilityIsAffectedByPersonalCalendar Booleano True significa que si el miembro staff es un usuario de Microsoft 365, la API de reservas utiliza el calendario personal del miembro del personal en Microsoft 365, así como la propiedad workingHours para determinar la disponibilidad.
colorIndex Int32 Identifica un color que representa al miembro del personal. El color corresponde a la paleta de colores de la página detalles del personal de la aplicación bookings.
displayName String El nombre del miembro del personal, tal y como se muestra a los clientes.
emailAddress Cadena La dirección de correo electrónico del miembro del personal. Puede ser en el mismo inquilino de Microsoft 365 como empresa o en un dominio de correo electrónico diferente. Esta dirección de correo se usa si la propiedad sendConfirmationsToOwner está establecida en true en la Directiva de programación de la empresa.
role string El rol del empleado en la empresa. Los valores posibles son: guest, administrator, viewer y externalGuest.
useBusinessHours Booleano True significa que la disponibilidad del miembro de personal está determinada por la propiedad businessHours de la empresa. False significa que la disponibilidad está determinada por el valor de la propiedad workingHouse del miembro del personal.
workingHours colección bookingWorkHours Intervalo de horas, cada día de la semana, que el miembro del personal está disponible para la reserva.

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 un lunes.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@M365B489948.onmicrosoft.com/staffmembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json

{
    "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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"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",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        }
    ]
}
Respuesta

Este es un ejemplo de la respuesta.

HTTP/1.1 204 No Content