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 à mettre à 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
customerEmailAddress	Chaîne	Adresse SMTP du bookingCustomer qui réserve le rendez-vous.
customerName	Chaîne	Nom du client.
customerNotes	Chaîne	Notes du client associé à ce rendez-vous. Vous pouvez obtenir la valeur uniquement lorsque vous lisez ce bookingAppointment par son ID. Vous ne pouvez définir cette propriété que lorsque vous créez initialement un rendez-vous avec un nouveau client.
customerPhone	Chaîne	Numéro de téléphone du client.
clientèle	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. Optional.
customerTimeZone	Chaîne	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 .
end	dateTimeTimeZone	Date, heure et fuseau horaire de fin du rendez-vous.
invoiceStatus	string	Status de la facture. Les valeurs possibles sont , draftreviewing, open, canceledpaid, et corrective.
isCustomerAllowedToManageBooking	Valeur booléenne	Indique que le client peut gérer les réservations créées par le personnel. La valeur par défaut est false.
filledAttendeesCount	Int32	Nombre actuel de clients dans le rendez-vous. Obligatoire.
isLocationOnline	Valeur booléenne	True indique que le rendez-vous est tenu en ligne. La valeur par défaut est false.
maximumAttendeesCount	Int32	Nombre maximal de clients autorisés dans le rendez-vous. Obligatoire.
optOutOfCustomerEmail	Valeur booléenne	True 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	Chaîne	Autre ID de suivi 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.
serviceId	Chaîne	ID du bookingService associé à ce rendez-vous.
serviceLocation	location	Emplacement où le service est fourni.
serviceName	Chaîne	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	Chaîne	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	Valeur booléenne	True indique que des notifications PAR SMS sont 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.
start	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",
    "end":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "start":{
        "@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