Type de ressource bookingStaffMember

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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 a la valeur true, l’API Bookings examine d’abord les heures de disponibilité générale du membre du personnel (comme déterminé 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.

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 Aucune Supprimez un membre du personnel dans le bookingBusiness spécifié.

Propriétés

Propriété Type Description
availabilityIsAffectedByPersonalCalendar Valeur booléenne Vrai 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.
colorIndex Int32 Identifie une couleur pour représenter le membre du personnel. La couleur correspond à la palette de couleurs dans la page Détails du personnel enseignant de l’application Bookings.
createdDateTime DateTimeOffset Date, heure et fuseau horaire de création du membre du personnel.
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 leur est attribuée est créée ou modifiée. La valeur par défaut est true
lastUpdatedDateTime DateTimeOffset Date, heure et fuseau horaire de la dernière mise à jour du membre du personnel.
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

Le code JSON suivant est une représentation de la ressource.

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