Mettre à jour bookingAppointment

Espace de noms: microsoft.graph

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

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) BookingsAppointment.ReadWrite.All Bookings.Manage.All, Bookings.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application BookingsAppointment.ReadWrite.All Bookings.Manage.All, Bookings.Read.All, Bookings.ReadWrite.All

Remarque

Si vous créez une application personnalisée à l’aide d’autorisations d’application, vous devez suivre la validation des règles d’entreprise.

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 du client pour 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 String Fuseau horaire du client. Pour obtenir la liste des valeurs possibles, consultez dateTimeTimeZone.
durée Durée Longueur du rendez-vous, indiquée 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 Boolean Si truela valeur est , indique que le rendez-vous se tiendra en ligne. La valeur par défaut est false.
maximumAttendeesCount Int32 Nombre maximal de clients autorisés dans le rendez-vous. Obligatoire.
optOutOfCustomerEmail Boolean Si truela valeur est , indique que le bookingCustomer pour ce rendez-vous ne souhaite pas recevoir de confirmation pour ce rendez-vous.
postBuffer Durée Durée de réserve après la fin du rendez-vous, pour le nettoyage, par exemple. La valeur est exprimée au format ISO8601 .
preBuffer Durée Durée de réservation avant le début du rendez-vous, pour la 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 permettant d’offrir une flexibilité pour la structure tarifaire des services. Les valeurs possibles sont les suivantes : undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
Rappels Collection bookingReminder Collection de rappels clients envoyés pour ce rendez-vous. La valeur de cette propriété est disponible uniquement lors de la lecture de cet objet bookingAppointment par son ID.
selfServiceAppointmentId String 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 à un membre du personnel au nom du client. Pris en charge uniquement 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 fourni.
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 Remarques d’un bookingStaffMember. La valeur de cette propriété est disponible uniquement lors de la lecture de cet objet bookingAppointment par son ID.
smsNotificationsEnabled Boolean Si truela valeur est , indique que les notifications SMS seront envoyées aux clients pour le rendez-vous. La valeur par défaut est false.
staffMemberIds String collection ID de chaque bookingStaffMember qui est planifié dans ce rendez-vous.
startDateTime dateTimeTimeZone Date, heure et fuseau horaire de début du rendez-vous.

Remarque

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

  • Assurez-vous que les clients existent dans le calendrier Booking. Si ce n’est pas le cas, créez à l’aide de l’opération Create 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 n’est pas inclus dans l’objet rendez-vous.

Réponse

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

Exemples

Demande

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

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"
    }
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content