Actualizar bookingstaffmember

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta 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 la versión 1.0, use el selector de Versión.

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 opcionales

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

Cuerpo de 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 incluya valores existentes que no hayan cambiado.

Propiedad Tipo Descripción
availabilityIsAffectedByPersonalCalendar Booleano True significa que si el miembro del personal es un usuario de Microsoft 365, la API de Bookings usa el calendario personal del miembro del personal en Microsoft 365, así como la propiedad workingHours para determinar la disponibilidad.
colorIndex Int32 Identifica un color para representar 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 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 se establece en true 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/beta/solutions/bookingbusinesses/contosolunchdelivery@contoso.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

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content