bookingStaffMember-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Stellt einen Mitarbeiter dar, der Dienstleistungen in einem bookingBusiness bereitstellt.

Mitarbeiter können Teil des Microsoft 365-Mandanten sein, in dem das Buchungsgeschäft konfiguriert ist, oder sie können E-Mail-Dienste von anderen E-Mail-Anbietern verwenden.

Beim Buchen von Terminen berücksichtigt die Bookings-API die folgenden Einstellungen, um die Verfügbarkeit eines Mitarbeiters zu ermitteln:

  1. Standardmäßig stellen die Betriebszeiten des Unternehmens (die businessHours-Eigenschaft der Entität bookingBusiness ) die allgemeine Verfügbarkeit des Mitarbeiters dar.
  2. Wenn useBusinessHours false ist, stellen die spezifischen Arbeitszeiten des Mitarbeiters (workingHours-Eigenschaft der Entität bookingStaffmember ) die allgemeine Verfügbarkeit dieses Mitglieds dar.
  3. Wenn availabilityIsAffectedByPersonalCalendar true ist, prüft die Bookings-API zunächst die allgemein verfügbaren Stunden des Mitarbeiters (je nach Nr. 1 oder Nr. 2) und überprüft die Verfügbarkeit während dieser Zeiten im persönlichen Kalender des Mitarbeiters, bevor eine Buchung vorgenommen wird.

Erbt von bookingStaffMemberBase.

Microsoft Bookings unterstützt maximal 100 Mitarbeiter in einem Buchungskalender.

Methoden

Methode Rückgabetyp Beschreibung
Mitarbeiter auflisten bookingStaffMember-Sammlung Ruft eine Liste der bookingStaffMember-Objekte im angegebenen bookingBusiness ab.
bookingStaff erstellen bookingStaffMember-Sammlung Erstellen Sie eine neue bookingStaffMember in der angegebenen bookingBusiness.
BookingStaffMember abrufen bookingStaffMember Ruft die Eigenschaften und Beziehungen eines bookingStaffMember im angegebenen bookingBusiness ab.
Update Keine Aktualisieren Sie die Eigenschaften eines bookingStaffMember-Werts im angegebenen bookingBusiness.Update the properties of a bookingStaffMember in the specified bookingBusiness.
Delete Keine Löschen Sie einen Mitarbeiter im angegebenen bookingBusiness.

Eigenschaften

Eigenschaft Typ Beschreibung
availabilityIsAffectedByPersonalCalendar Boolesch True bedeutet, dass, wenn der Mitarbeiter ein Microsoft 365-Benutzer ist, die Bookings-API die Verfügbarkeit des Mitarbeiters in seinem persönlichen Kalender in Microsoft 365 überprüft, bevor eine Buchung erfolgt.
displayName String Der Name des Mitarbeiters, wie er den Kunden angezeigt wird. Erforderlich.
emailAddress String Die E-Mail-Adresse des Mitarbeiters. Dies kann sich im selben Microsoft 365-Mandanten wie das Unternehmen oder in einer anderen E-Mail-Domäne befinden. Diese E-Mail-Adresse kann verwendet werden, wenn die sendConfirmationsToOwner-Eigenschaft in der Zeitplanungsrichtlinie des Unternehmens auf true festgelegt ist. Erforderlich.
id String Die ID des Mitarbeiters im GUID-Format. Schreibgeschützt.
isEmailNotificationEnabled Boolesch True gibt an, dass ein Mitarbeiter per E-Mail benachrichtigt wird, wenn eine ihm zugewiesene Buchung erstellt oder geändert wird.
role bookingStaffRole Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Beachten Sie, dass Sie den Anforderungsheader Prefer: include-unknown-enum-members verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: scheduler, teamMember. Erforderlich.
timeZone String Die Zeitzone des Mitarbeiters. Eine Liste der möglichen Werte finden Sie unter dateTimeTimeZone.
useBusinessHours Boolesch True bedeutet, dass die Verfügbarkeit des Mitarbeiters in der businessHours-Eigenschaft des Unternehmens angegeben ist. False bedeutet, dass die Verfügbarkeit durch die WorkingHours-Eigenschaftseinstellung des Mitarbeiters bestimmt wird.
workingHours bookingWorkHours-Sammlung Der Bereich der Stunden an jedem Tag der Woche, die der Mitarbeiter zur Buchung zur Verfügung steht. Standardmäßig werden sie so initialisiert, dass sie mit der businessHours-Eigenschaft des Unternehmens identisch sind.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der 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"}]
}