Mettre à jour bookingservice
Espace de noms: microsoft.graph
Mettez à jour les propriétés d’un objet bookingService dans le bookingBusiness spécifié.
Voici quelques exemples que vous pouvez personnaliser pour un service :
- Price
- Durée typique d’un rendez-vous
- Reminders
- Toute mémoire tampon à configurer avant ou après le service
- Paramètres de stratégie de planification , tels que la notification minimale de réservation ou d’annulation, et si les clients peuvent sélectionner des membres du personnel spécifiques pour un rendez-vous.
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) | Bookings.ReadWrite.All | Bookings.Manage.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | Bookings.ReadWrite.All | Bookings.Manage.All |
Requête HTTP
PATCH /solutions/bookingBusinesses/{id}/services/{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 |
|---|---|---|
| customQuestions | collection bookingQuestionAssignment | Il contient un ensemble de questions personnalisées associées à un service particulier. Optional. |
| defaultDuration | Durée | Longueur par défaut du service représentée en nombre de jours, d’heures, de minutes et de secondes. Par exemple, P11D23H59M59.9999999999999S. |
| defaultLocation | location | Emplacement physique par défaut du service. |
| defaultPrice | Double | Prix monétaire par défaut pour le service. |
| defaultPriceType | bookingPriceType | Mode de facturation par défaut du service. Les valeurs possibles sont les suivantes : undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue. |
| defaultReminders | Collection bookingReminder | Ensemble de rappels par défaut pour un rendez-vous de ce service. La valeur de cette propriété est disponible uniquement lors de la lecture de ce bookingService par son ID. |
| description | Chaîne | Description textuelle du service. |
| displayName | Chaîne | Un nom de service. |
| id | Chaîne | Identificateur unique du bookingService. En lecture seule. |
| isAnonymousJoinEnabled | Valeur booléenne |
True si l’URL permettant de rejoindre le rendez-vous de manière anonyme (anonymousJoinWebUrl) est générée pour le rendez-vous réservé pour ce service. |
| 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. |
| isHiddenFromCustomers | Valeur booléenne |
True indique que le service n’est pas disponible pour les clients pour la réservation. |
| isLocationOnline | Valeur booléenne |
True indique que les rendez-vous pour le service sont en ligne. La valeur par défaut est false. |
| languageTag | Chaîne | Langue de la page de réservation en libre-service. |
| maximumAttendeesCount | Int32 | Nombre maximal de clients autorisés dans un service. |
| notes | String | Informations supplémentaires sur ce service. |
| postBuffer | Durée | Temps de mise en mémoire tampon après la fin d’un rendez-vous pour ce service et avant que le prochain rendez-vous client puisse être réservé. |
| preBuffer | Durée | Temps de mise en mémoire tampon avant qu’un rendez-vous pour ce service puisse démarrer. |
| schedulingPolicy | bookingSchedulingPolicy | Ensemble de stratégies qui déterminent la façon dont les rendez-vous pour ce type de service doivent être créés et gérés. |
| smsNotificationsEnabled | Valeur booléenne |
True indique que des notifications PAR SMS peuvent être envoyées aux clients pour le rendez-vous du service. La valeur par défaut est false. |
| staffMemberIds | String collection | Représente les membres du personnel qui fournissent ce service. |
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.
Exemple
Demande
L’exemple suivant met à jour la durée du service spécifié.
PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json
{
"@odata.type":"#microsoft.graph.bookingService",
"defaultDuration":"PT30M"
}
Réponse
L’exemple suivant montre la réponse.
HTTP/1.1 204 No Content