Type de ressource bookingStaffMember
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 :
- 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.
- 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.
- 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 |
|---|---|---|
| List | collection bookingStaffMember | Obtenez la liste des objets bookingStaffMember dans le bookingBusiness spécifié. |
| Create | collection bookingStaffMember | Create un nouveau 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 | 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)"
}