bookingStaffMember-Ressourcentyp

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.

Bei der Buchung von Terminen berücksichtigt die Bookings-API die folgenden Einstellungen, um die Verfügbarkeit eines Mitarbeiters zu bestimmen:

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 (wie durch #1 oder #2 bestimmt), 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
List	bookingStaffMember-Sammlung	Ruft eine Liste der bookingStaffMember-Objekte im angegebenen bookingBusiness ab.
Create	bookingStaffMember-Sammlung	Erstellen Sie eine neue bookingStaffMember in der angegebenen bookingBusiness.
Get	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.
createdDateTime	DateTimeOffset	Das Datum, die Uhrzeit und die Zeitzone, in der der Mitarbeiter erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
displayName	Zeichenfolge	Der Name des Mitarbeiters, wie er den Kunden angezeigt wird. Erforderlich.
emailAddress	Zeichenfolge	Die E-Mail-Adresse des Mitarbeiters. Diese E-Mail-Adresse 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	Zeichenfolge	Die ID des Mitarbeiters im GUID-Format. Schreibgeschützt.
isEmailNotificationEnabled	Boolesch	Gibt an, dass ein Mitarbeiter per E-Mail benachrichtigt wird, wenn eine ihm zugewiesene Buchung erstellt oder geändert wird. Der Standardwert ist true.
membershipStatus	bookingStaffMembershipStatus	Der Mitgliedschaftsstatus des Mitarbeiters im Unternehmen. Mögliche Werte: active, pendingAcceptance, rejectedByStaff, unknownFutureValue
lastUpdatedDateTime	DateTimeOffset	Datum, Uhrzeit und Zeitzone der letzten Aktualisierung des Mitarbeiters. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
role	bookingStaffRole	Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: scheduler, teamMember. Erforderlich.
timeZone	Zeichenfolge	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

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@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"}]
}