Compartir a través de


tipo de recurso bookingStaffMember

Espacio de nombres: microsoft.graph

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 tiene en cuenta 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.

Hereda de bookingStaffMemberBase.

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

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 Cree 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 Descripción
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.
createdDateTime DateTimeOffset Fecha, hora y zona horaria en que se creó el miembro del personal. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
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 un miembro del personal recibe una notificación por correo electrónico cuando se crea o cambia una reserva asignada a ellos. El valor predeterminado es true.
membershipStatus bookingStaffMembershipStatus Estado de pertenencia del miembro del personal de la empresa. Los valores posibles son: active, pendingAcceptance, rejectedByStaff y unknownFutureValue.
lastUpdatedDateTime DateTimeOffset Fecha, hora y zona horaria en que se actualizó por última vez el miembro del personal. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
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

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.bookingStaffMember",
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "lastUpdatedDateTime": "String (timestamp)",
  "role": "String",
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}