bookingAppointment: cancelar

Espacio de nombres: microsoft.graph

Cancele el bookingAppointment especificado en el bookingBusiness especificado y envíe un mensaje al cliente y al personal implicados.

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 Bookings.ReadWrite.All Bookings.Manage.All

Solicitud HTTP

POST /solutions/bookingBusinesses/{id}/appointments/{id}/cancel

Encabezados de solicitud

Nombre Descripción
Autorización Portador {code}

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con el parámetro siguiente.

Parámetro Tipo Descripción
cancellationMessage Cadena Un mensaje para confirmar con el cliente que la cita se ha cancelado.

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.

Si intenta cancelar una cita que no existe, este método devuelve HTTP 404 Not Found.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

{
  "cancellationMessage": "Your appointment has been successfully cancelled. Please call us again."
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content