Mettre à jour bookingAppointment

Espace de noms: microsoft.graph

Met à jour les propriétés d’un objet bookingAppointment dans l’objet bookingBusiness spécifié.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) BookingsAppointment.ReadWrite.All, Bookings.ReadWrite.All, Bookings.Manage.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Requête HTTP

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

En-têtes de demande

Nom Description
Autorisation Porteur {code}. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés qui doivent être mises à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Propriété Type Description
clients collection bookingCustomerInformation Il répertorie les propriétés client d’un rendez-vous. Un rendez-vous contient une liste d’informations client et chaque unité indique les propriétés d’un client qui fait partie de ce rendez-vous. Facultatif.
customerTimeZone Chaîne Fuseau horaire du client. Pour obtenir la liste des valeurs possibles, voir dateTimeTimeZone.
durée Durée Longueur du rendez-vous, au format ISO8601 .
endDateTime dateTimeTimeZone Date, heure et fuseau horaire de fin du rendez-vous.
filledAttendeesCount Int32 Nombre actuel de clients dans le rendez-vous. Obligatoire.
isLocationOnline Booléen Si true, indique que le rendez-vous sera tenu en ligne. La valeur par défaut est false.
maximumAttendeesCount Int32 Nombre maximal de clients autorisés dans le rendez-vous. Obligatoire.
optOutOfCustomerEmail Booléen Si true, indique que le bookingCustomer de ce rendez-vous ne souhaite pas recevoir de confirmation pour ce rendez-vous.
postBuffer Durée Durée de réserve à la fin du rendez-vous, par exemple pour le nettoyage. La valeur est exprimée au format ISO8601 .
preBuffer Durée Durée à réserver avant le début du rendez-vous, en vue de sa préparation, par exemple. La valeur est exprimée au format ISO8601 .
prix Double Prix normal d’un rendez-vous pour le bookingService spécifié.
priceType bookingPriceType Paramètre qui offre une flexibilité pour la structure des tarifs des services. Les valeurs possibles sont les suivantes : undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
rappels collection bookingReminder Collection de rappels de clients envoyés pour ce rendez-vous. La valeur de cette propriété est disponible uniquement lors de la lecture de cette bookingAppointment par son ID.
selfServiceAppointmentId String Un ID de suivi supplémentaire pour le rendez-vous, si le rendez-vous a été créé directement par le client sur la page de planification, par opposition à par un membre du personnel au nom du client. Uniquement pris en charge pour le rendez-vous si maxAttendeeCount est 1.
serviceId Chaîne ID du bookingService associé à ce rendez-vous.
serviceLocation location Emplacement où le service est remis.
serviceName String Nom du bookingService associé à ce rendez-vous.
Cette propriété est facultative lors de la création d’un rendez-vous. S’il n’est pas spécifié, il est calculé à partir du service associé au rendez-vous par la propriété serviceId .
serviceNotes String Notes d’un bookingStaffMember. La valeur de cette propriété est disponible uniquement lors de la lecture de cette bookingAppointment par son ID.
smsNotificationsEnabled Boolean Si true, indique que des notifications SMS seront envoyées aux clients pour le rendez-vous. La valeur par défaut est false.
staffMemberIds Collection de chaînes ID de chaque bookingStaffMember qui est programmé dans ce rendez-vous.
startDateTime dateTimeTimeZone Date, heure et fuseau horaire de début du rendez-vous.

Notes

Si le nombre maximal de clients (maximumAttedeesCount) autorisés dans le service est supérieur à 1 :

  • Assurez-vous que les clients existent dans le calendrier de réservation. Si ce n’est pas le cas, créez à l’aide de l’opération Créer bookingCustomer .
  • Passez des ID client valides lorsque vous créez ou mettez à jour le rendez-vous. Si l’ID client n’est pas valide, ce client ne sera pas inclus dans l’objet de rendez-vous.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content. Elle ne renvoie rien dans le corps de la réponse.

Exemples

Demande

L’exemple suivant modifie la date de service d’un jour.

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.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"
    }
}

Réponse

Voici un exemple de réponse.

HTTP/1.1 204 No Content