Partager via


Type de ressource bookingStaffMember

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’activité 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
List collection bookingStaffMember Obtenez la liste des objets bookingStaffMember dans le bookingBusiness spécifié.
Create collection bookingStaffMember Créez un bookingStaffMember dans le bookingBusiness spécifié.
Obtenir 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 Aucune Supprimez un membre du personnel dans le bookingBusiness spécifié.

Propriétés

Propriété Type Description
availabilityIsAffectedByPersonalCalendar Valeur booléenne 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.
createdDateTime DateTimeOffset Date, heure et fuseau horaire de création du membre du personnel. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
displayName Chaîne Nom du membre du personnel, tel qu’affiché aux clients. Obligatoire.
emailAddress Chaîne Adresse e-mail du membre du personnel. Cette adresse e-mail 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 Valeur booléenne Indique qu’un membre du personnel est averti par e-mail lorsqu’une réservation qui lui est attribuée est créée ou modifiée. La valeur par défaut est true.
membershipStatus bookingStaffMembershipStatus Statut d’adhésion du membre du personnel dans l’entreprise. Les valeurs possibles sont les suivantes : active, pendingAcceptance, rejectedByStaff, unknownFutureValue.
lastUpdatedDateTime DateTimeOffset Date, heure et fuseau horaire de la dernière mise à jour du membre du personnel. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
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. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes 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 Valeur booléenne 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

La représentation JSON suivante montre le type de ressource.

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