tipo de recurso bookingAppointment
Espacio de nombres: microsoft.graph
Representa una cita de cliente para un bookingService, realizado por un conjunto de miembros del personal, proporcionado por una empresa de Microsoft Bookings.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | bookingAppointment collection | Obtenga una lista de objetos bookingAppointment en el objeto bookingBusiness especificado. |
| Crear | bookingAppointment | Cree un nuevo bookingAppointment para el bookingBusiness especificado. |
| Get | bookingAppointment | Lea las propiedades y relaciones del objeto bookingAppointment . |
| Actualizar | bookingAppointment | Actualice un objeto bookingAppointment . |
| Delete | Ninguno | Eliminar un objeto bookingAppointment . |
| Cancelación de una cita | 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. |
| appointmentLabel | Cadena | Etiqueta personalizada que los usuarios pueden marcar en esta cita. |
| createdDateTime | DateTimeOffset | Fecha, hora y zona horaria en que se creó la cita. 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. |
| customerEmailAddress | Cadena | La dirección SMTP de bookingCustomer que reserva la cita. |
| customerName | Cadena | Nombre del cliente. |
| customerNotes | Cadena | Notas del cliente asociado a esta cita. Solo puede obtener el valor cuando lea esta bookingAppointment por su identificador. Esta propiedad solo se puede establecer cuando se crea inicialmente una cita con un nuevo cliente. |
| customerPhone | Cadena | El número de teléfono del cliente. |
| clientela | 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 . |
| end | dateTimeTimeZone | Fecha, hora y zona horaria cuando finaliza la cita. |
| filledAttendeesCount | Int32 | Número actual de clientes en la cita. |
| id | Cadena | Identificador del bookingAppointment. Solo lectura. |
| isCustomerAllowedToManageBooking | Booleano | Indica que el cliente puede administrar las reservas creadas por el personal. El valor predeterminado es false. |
| isLocationOnline | Booleano | Indica que la cita se mantiene en línea. El valor predeterminado es false. |
| joinWebUrl | Cadena | Dirección URL de la reunión en línea de la cita. |
| lastUpdatedDateTime | DateTimeOffset | Fecha, hora y zona horaria en que se actualizó por última vez la empresa de reserva. 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. |
| 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 | Otro identificador de seguimiento para la cita, si el cliente creó la cita directamente en la página de programación, en lugar de por un miembro del personal en nombre del cliente. |
| 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. |
| start | dateTimeTimeZone | Fecha, hora y zona horaria cuando comienza la cita. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.bookingAppointment",
"additionalInformation": "String",
"anonymousJoinWebUrl": "String",
"appointmentLabel": "String",
"createdDateTime": "String (timestamp)",
"customerEmailAddress": "String",
"customerName": "String",
"customerNotes": "String",
"customerPhone": "String",
"customers": [{"@odata.type": "microsoft.graph.bookingCustomerInformation"}],
"customerTimeZone": "String",
"duration": "String (duration)",
"end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"filledAttendeesCount": "Int32",
"id": "String (identifier)",
"isCustomerAllowedToManageBooking": "Boolean",
"isLocationOnline": "Boolean",
"joinWebUrl": "String",
"lastUpdatedDateTime": "String (timestamp)",
"maximumAttendeesCount": "Int32",
"optOutOfCustomerEmail": "Boolean",
"postBuffer": "String (duration)",
"preBuffer": "String (duration)",
"price": "Double",
"priceType": "String",
"reminders": [{"@odata.type": "microsoft.graph.bookingReminder"}],
"selfServiceAppointmentId": "String",
"serviceId": "String",
"serviceLocation": {"@odata.type": "microsoft.graph.location"},
"serviceName": "String",
"serviceNotes": "String",
"smsNotificationsEnabled": "Boolean",
"staffMemberIds": ["String"],
"start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"}
}