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 true la 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 true la 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 true la 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : tout au long de 2024, nous allons éliminer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d'informations, consultez :Envoyer et afficher des commentaires pour