Partager via

Utiliser l’API Microsoft Bookings dans Microsoft Graph pour les réservations partagées

  • Article

Microsoft Bookings permet aux organization d’entreprise et aux propriétaires de petites entreprises de gérer les réservations et les informations des clients dans les réservations partagées avec une configuration minimale. Un dirigeant d’entreprise peut créer une ou plusieurs entreprises qui offrent chacune leurs propres services. Le dirigeant peut configurer les employés et indiquer les services que chaque employé assure. Un client peut prendre un rendez-vous pour un service proposé par cette entreprise dans une application mobile ou en ligne. Microsoft Bookings s’assure que l’heure de rendez-vous est tenue à jour pour l’entreprise, les membres du personnel et les clients concernés.

Importante

L’API Microsoft Bookings dans Microsoft Graph s’applique uniquement aux réservations partagées. L’API ne s’applique pas aux réservations personnelles.

Côté programme, un objet bookingBusiness dans l’API Bookings implique :

Utilisation de l’API REST Microsoft Bookings

Suivez la procédure suivante avant de proposer aux clients de prendre rendez-vous. Assurez-vous que vous fournissez les jetons d’accès correspondant aux opérations.

  1. Vérifiez que l’entreprise a un abonnement Microsoft 365 Business Premium.
  2. Créez un objet bookingBusiness en envoyant une opération POST au jeu d’entités. Vous devez au moins spécifier un nom pour la nouvelle entreprise, que les clients verront :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Contoso"
}

Utilisez la propriété id du nouvel objet bookingBusiness renvoyé dans la réponse POST pour continuer à personnaliser les paramètres de l’entreprise, puis ajoutez les employés et les services de l’entreprise.

  1. Ajoutez les employés pour l’entreprise :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/staffMembers
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Dana Swope",
    "emailAddress": "danas@contoso.com",
    "role": "externalGuest"
}
  1. Définissez les services proposés par l’entreprise :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/services
Authorization: Bearer {access token}
Content-Type: application/json

{
    "displayName":"Bento"
}
  1. Publiez la page de planification pour l’entreprise afin de permettre aux clients et aux exploitants de commencer à prendre rendez-vous :
POST https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/{id}/publish
Authorization: Bearer {access token}

En général, pour répertorier toutes les entreprises de réservation dans le client Microsoft 365 :

GET https://graph.microsoft.com/v1.0/solutions/bookingBusinesses
Authorization: Bearer {access token}

Cas d’utilisation courants

Le tableau suivant répertorie les opérations courantes réalisées par les entreprises dans l’API Bookings.

Cas d’utilisation Ressources REST Voir aussi
Créer, obtenir, mettre à jour ou supprimer une entreprise bookingBusiness Méthodes de l’objet bookingBusiness
Mettre à jour la stratégie de planification bookingSchedulingPolicy Mise à jour d’un objet bookingBusiness
Ajouter, obtenir, mettre à jour ou supprimer des employés bookingStaffMember Méthodes de l’objet bookingStaffMember
Ajouter, obtenir, mettre à jour ou supprimer des services bookingService Méthodes de l’objet bookingService
Ajouter, obtenir, mettre à jour ou supprimer des questions personnalisées bookingCustomQuestion Méthodes de bookingCustomQuestion
Ajouter, obtenir, mettre à jour ou supprimer des clients bookingCustomer Méthodes de bookingCustomer
Publier ou annuler la publication de la page de planification bookingBusiness Publication
Annuler la publication
Créer, obtenir, mettre à jour, supprimer ou annuler un rendez-vous bookingAppointment Méthodes de l’objet bookingAppointment
Obtenir les rendez-vous compris dans une plage de dates bookingBusiness Liste des objets calendarView dans Bookings
Obtenir la devise bookingCurrency Méthodes de l’objet bookingCurrency

Contenu connexe