tipo de recurso 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.

Representa a un miembro del personal que proporciona servicios en un bookingBusiness.

Los miembros del personal pueden formar parte del inquilino de Microsoft 365 donde está configurada la empresa de reservas o pueden usar servicios de correo electrónico de otros proveedores de correo electrónico.

Al reservar citas, la API de Bookings considera la siguiente configuración para determinar la disponibilidad de un miembro del personal:

1. De forma predeterminada, las horas de funcionamiento de la empresa (la propiedad businessHours de la entidad bookingBusiness ) representan la disponibilidad general del miembro del personal.
2. Si useBusinessHours es false, las horas de trabajo específicas del miembro del personal (propiedad workingHours de la entidad bookingStaffmember ) representan la disponibilidad general de ese miembro.
3. Si availabilityIsAffectedByPersonalCalendar es true, la API de Bookings examinaría primero las horas disponibles con carácter general del miembro del personal (según lo determinado por #1 o #2) y comprobaría la disponibilidad durante esas horas en el calendario personal del miembro del personal, antes de realizar una reserva.

Microsoft Bookings admite un máximo de 100 miembros del personal en un calendario de reserva.

Métodos

Método	Tipo de valor devuelto	Descripción
List	colección bookingStaffMember	Obtenga una lista de objetos bookingStaffMember en el bookingBusiness especificado.
Crear	colección bookingStaffMember	Create un nuevo bookingStaffMember en el bookingBusiness especificado.
Get	bookingStaffMember	Obtenga las propiedades y las relaciones de un bookingStaffMember en el bookingBusiness especificado.
Actualizar	Ninguno	Actualice las propiedades de un bookingStaffMember en el bookingBusiness especificado.
Delete	Ninguno	Elimine un miembro del personal de la clase bookingBusiness especificada.

Propiedades

Propiedad	Tipo	Description
availabilityIsAffectedByPersonalCalendar	Booleano	True significa que si el miembro del personal es un usuario de Microsoft 365, la API de Bookings comprobaría la disponibilidad del miembro del personal en su calendario personal en Microsoft 365, antes de realizar una reserva.
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.
createdDateTime	DateTimeOffset	Fecha, hora y zona horaria en que se creó el miembro del personal.
displayName	Cadena	Nombre del miembro del personal, tal como se muestra a los clientes. Obligatorio.
emailAddress	Cadena	Dirección de correo electrónico del miembro del personal. Esta dirección de correo electrónico 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 puede usar si la propiedad sendConfirmationsToOwner se establece en true en la directiva de programación de la empresa. Necesario.
id	Cadena	Identificador del miembro del personal, en formato GUID. Solo lectura.
isEmailNotificationEnabled	Booleano	Indica que se notifica a los miembros del personal por correo electrónico cuando se crea o cambia una reserva asignada a ellos. El valor predeterminado es true
lastUpdatedDateTime	DateTimeOffset	Fecha, hora y zona horaria en que se actualizó por última vez el miembro del personal.
role	bookingStaffRole	El rol del miembro del personal en la empresa. Valores posibles: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: scheduler, teamMember. Obligatorio.
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 es la especificada en la propiedad businessHours de la empresa. False significa que la disponibilidad viene determinada por el valor de la propiedad workingHours 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. De forma predeterminada, se inicializan para que sean iguales que la propiedad businessHours de la empresa.

Relaciones

Ninguno

Representación JSON

El siguiente JSON es una representación del recurso.

{
  "@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)"
}