Type de ressource bookingStaffMember

  • Article

Espace de noms: microsoft.graph

Représente un membre du personnel qui fournit des services dans un bookingBusiness.

Les membres du personnel peuvent faire partie du client Microsoft 365 où l’entreprise de réservation est configurée, ou ils peuvent utiliser les services de messagerie d’autres fournisseurs de messagerie.

Lors de la réservation de rendez-vous, l’API Bookings prend en compte les paramètres suivants pour déterminer la disponibilité d’un membre du personnel :

  1. Par défaut, les heures d’ouverture de l’entreprise (la propriété businessHours de l’entité bookingBusiness ) représentent la disponibilité générale du membre du personnel.
  2. Si useBusinessHours a la valeur false, les heures de travail spécifiques du membre du personnel (propriété workingHours de l’entité bookingStaffmember ) représentent la disponibilité générale de ce membre.
  3. Si availabilityIsAffectedByPersonalCalendar est vrai, l’API Bookings examine d’abord les heures de disponibilité générale du membre du personnel (telles que déterminées par #1 ou #2), puis vérifie la disponibilité pendant ces heures dans le calendrier personnel du membre du personnel, avant d’effectuer une réservation.

Hérite de bookingStaffMemberBase.

Microsoft Bookings prend en charge un maximum de 100 membres du personnel dans un calendrier de réservation.

Méthodes

Méthode Type renvoyé Description
Répertorier les membres du personnel collection bookingStaffMember Obtenez la liste des objets bookingStaffMember dans le bookingBusiness spécifié.
Créer bookingStaff collection bookingStaffMember Créez un bookingStaffMember dans le bookingBusiness spécifié.
Obtenir bookingStaffMember bookingStaffMember Obtenez les propriétés et les relations d’un bookingStaffMember dans le bookingBusiness spécifié.
Mettre à jour Aucun Mettez à jour les propriétés d’un bookingStaffMember dans le bookingBusiness spécifié.
Supprimer Aucun Supprimez un membre du personnel dans le bookingBusiness spécifié.

Propriétés

Propriété Type Description
availabilityIsAffectedByPersonalCalendar Boolean True signifie que si le membre du personnel est un utilisateur Microsoft 365, l’API Bookings vérifie la disponibilité du membre du personnel dans son calendrier personnel dans Microsoft 365, avant d’effectuer une réservation.
displayName Chaîne Nom du membre du personnel, tel qu’affiché aux clients. Obligatoire.
emailAddress Chaîne Adresse e-mail du membre du personnel. Cela peut se trouver dans le même locataire Microsoft 365 que l’entreprise, ou dans un autre domaine de messagerie. Cette adresse e-mail peut être utilisée si la propriété sendConfirmationsToOwner a la valeur true dans la stratégie de planification de l’entreprise. Obligatoire.
id Chaîne ID du membre du personnel, au format GUID. En lecture seule.
isEmailNotificationEnabled Boolean True indique qu’un membre du personnel sera averti par e-mail lorsqu’une réservation qui lui est attribuée est créée ou modifiée.
role bookingStaffRole Rôle du membre du personnel dans l’entreprise. Les valeurs possibles sont les suivantes : guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler et teamMember. Notez que vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : scheduler, teamMember. Obligatoire.
timeZone String Fuseau horaire du membre du personnel. Pour obtenir la liste des valeurs possibles, consultez dateTimeTimeZone.
useBusinessHours Boolean True signifie que la disponibilité du membre du personnel est spécifiée dans la propriété businessHours de l’entreprise. False signifie que la disponibilité est déterminée par le paramètre de propriété workingHours du membre du personnel.
workingHours collection bookingWorkHours Plage d’heures chaque jour de la semaine pendant laquelle le membre du personnel est disponible pour la réservation. Par défaut, ils sont initialisés pour être identiques à la propriété businessHours de l’entreprise.

Relations

Aucun.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}