tipo de recurso bookingAppointment

Espacio de nombres: microsoft.graph

Representa una cita de cliente para un bookingService, realizada por un conjunto de miembros del personal, proporcionada por una empresa Microsoft Bookings.

Nota:

Si crea una aplicación personalizada con permisos de aplicación, debe seguir la validación de reglas de negocio.

Métodos

Método	Tipo de valor devuelto	Descripción
Enumerar citas	bookingAppointment collection	Obtenga una lista de objetos bookingAppointment en el bookingbusiness especificado.
Creación de bookingAppointment	bookingAppointment	Cree un nuevo bookingAppointment para el bookingbusiness especificado.
Obtener bookingAppointment	bookingAppointment	Lea las propiedades y relaciones del objeto bookingAppointment .
Actualizar	Ninguno	Actualice un objeto bookingAppointment .
Delete	Ninguno	Eliminar un objeto bookingAppointment .
Cancel	Ninguno	Cancelar un objeto bookingAppointment .

Propiedades

Propiedad	Tipo	Descripción
additionalInformation	Cadena	Información adicional que se envía al cliente cuando se confirma una cita.
anonymousJoinWebUrl	Cadena	Dirección URL de la reunión a la que se va a unirse de forma anónima.
Clientes	bookingCustomerInformation collection	Colección de propiedades de cliente para una cita. Una cita contiene una lista de información del cliente y cada unidad indicará las propiedades de un cliente que forma parte de esa cita. Opcional.
customerTimeZone	Cadena	Zona horaria del cliente. Para obtener una lista de los valores posibles, vea dateTimeTimeZone.
duration	Duración	Longitud de la cita, indicada en formato ISO8601 .
endDateTime	dateTimeTimeZone	Fecha, hora y zona horaria que finaliza la cita.
filledAttendeesCount	Int32	Número actual de clientes en la cita
id	Cadena	Identificador del bookingAppointment. Solo lectura.
isLocationOnline	Booleano	Si truees , indica que la cita se mantendrá en línea. El valor predeterminado es false.
joinWebUrl	Cadena	Dirección URL de la reunión en línea de la cita.
maximumAttendeesCount	Int32	Número máximo de clientes permitidos en una cita. Si maximumAttendeesCount del servicio es mayor que 1, pase los identificadores de cliente válidos al crear o actualizar una cita. Para crear un cliente, use la operación Crear bookingCustomer .
optOutOfCustomerEmail	Booleano	Si true indica que bookingCustomer para esta cita no desea recibir una confirmación para esta cita.
postBuffer	Duración	Cantidad de tiempo que se reserva una vez finalizada la cita, para limpiar, por ejemplo. El valor se expresa en formato ISO8601 .
preBuffer	Duración	La cantidad de tiempo que se debe reservar antes de que comience la cita, para su preparación, como ejemplo. El valor se expresa en formato ISO8601 .
Precio	Doble	Precio normal de una cita para el bookingService especificado.
priceType	bookingPriceType	Una configuración para proporcionar flexibilidad para la estructura de precios de los servicios. Los valores posibles son: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet y unknownFutureValue.
Recordatorios	bookingReminder collection	Colección de recordatorios de clientes enviados para esta cita. El valor de esta propiedad solo está disponible al leer esta reservaAppointment por su identificador.
selfServiceAppointmentId	Cadena	Un identificador de seguimiento adicional para la cita, si el cliente ha creado la cita directamente en la página de programación, en lugar de un miembro del personal en nombre del cliente. Solo se admite para la cita si maxAttendeeCount es 1.
serviceId	Cadena	Identificador del bookingService asociado a esta cita.
serviceLocation	location	Ubicación donde se entrega el servicio.
Servicename	Cadena	Nombre del bookingService asociado a esta cita. Esta propiedad es opcional al crear una nueva cita. Si no se especifica, se calcula a partir del servicio asociado a la cita por la propiedad serviceId .
serviceNotes	Cadena	Notas de un bookingStaffMember. El valor de esta propiedad solo está disponible al leer esta reservaAppointment por su identificador.
smsNotificationsEnabled	Booleano	Si truees , indica que se enviarán notificaciones SMS a los clientes para la cita. El valor predeterminado es false.
staffMemberIds	Colección string	El identificador de cada bookingStaffMember que está programado en esta cita.
startDateTime	dateTimeTimeZone	Fecha, hora y zona horaria a la que comienza la cita.

Relaciones

Ninguna.

Representación JSON

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

{
  "additionalInformation": "String",
  "anonymousJoinWebUrl": "String",
  "customers": [
    {
      "@odata.type": "microsoft.graph.bookingCustomerInformation"
    }
  ],
  "duration": "String (timestamp)",
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "filledAttendeesCount": "Int32",
  "id": "String (identifier)",
  "isLocationOnline": "Boolean",
  "joinWebUrl": "String",
  "maximumAttendeesCount": "Int32",
  "optOutOfCustomerEmail": "Boolean",
  "postBuffer": "String (timestamp)",
  "preBuffer": "String (timestamp)",
  "price": "Double",
  "priceType": {"@odata.type": "microsoft.graph.bookingPriceType"},
  "reminders": [{"@odata.type": "microsoft.graph.bookingReminder"}],
  "selfServiceAppointmentId": "String",
  "serviceId": "String",
  "serviceLocation": {"@odata.type": "microsoft.graph.location"},
  "serviceName": "String",
  "serviceNotes": "String",
  "smsNotificationsEnabled": "Boolean",
  "staffMemberIds": ["String"],
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}
}