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, únicamente proporcione los valores de las propiedades que deben actualizarse. 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
Clientes	bookingCustomerInformation collection	Enumera las propiedades del cliente para una cita. Una cita contendrá 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. Obligatorio.
isLocationOnline	Booleano	Si truees , indica que la cita se mantendrá en línea. El valor predeterminado es false.
maximumAttendeesCount	Int32	Número máximo de clientes permitido en la cita. Obligatorio.
optOutOfCustomerEmail	Booleano	Si truees , 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 mediante 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.

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 appointment.

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",
    "endDateTime":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "startDateTime":{
        "@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