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 Description
Enumerar miembros del personal colección bookingStaffMember Obtenga una lista de objetos bookingStaffMember en el bookingBusiness especificado.
Creación de bookingStaff colección bookingStaffMember Cree un nuevo bookingStaffMember en el bookingBusiness especificado.
Obtener bookingStaffMember 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.
Eliminar 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)"
}