Actualizar bookingAppointment

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto bookingAppointment en el objeto bookingBusiness especificado.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	BookingsAppointment.ReadWrite.All	Bookings. Manage.All, Bookings. ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	BookingsAppointment.ReadWrite.All	Bookings. Manage.All, Bookings. Read.All, Bookings. ReadWrite.All

Nota:

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

Solicitud HTTP

PATCH /solutions/bookingBusinesses/{id}/appointments/{id}

Encabezados de solicitud

Nombre	Descripción
Autorización	{code} del portador. Necesario.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad	Tipo	Descripción
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	Enumera las propiedades del cliente para una cita. Una cita contiene una lista de información del cliente y cada unidad indica 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 que finaliza la cita.
invoiceStatus	string	Estado de la factura. Los valores posibles son: draft, reviewing, open, canceled, paidy corrective.
isCustomerAllowedToManageBooking	Booleano	Indica que el cliente puede administrar las reservas creadas por el personal. El valor predeterminado es false.
filledAttendeesCount	Int32	Número actual de clientes en la cita. Obligatorio.
isLocationOnline	Booleano	True indica que la cita se mantiene en línea. El valor predeterminado es false.
maximumAttendeesCount	Int32	Número máximo de clientes permitido en la cita. Obligatorio.
optOutOfCustomerEmail	Booleano	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	True indica que las notificaciones SMS se envían 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.

Nota:

Si el número máximo de clientes (maximumAttedeesCount) permitido en el servicio es mayor que 1:

• Asegúrese de que los clientes existen en el calendario de reservas. Si no lo hacen, cree mediante la operación Crear bookingCustomer .
• Pase identificadores de cliente válidos al crear o actualizar la cita. Si el identificador de cliente no es válido, ese cliente no se incluirá en el objeto de cita.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se cambia la fecha del servicio por un día.

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/appointments/AAMkADKnAAA=
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingAppointment",
    "end":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "start":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:00:00.0000000+00:00",
        "timeZone":"UTC"
    }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content