bookingStaffMember-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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.

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.
Colorindex	Int32	Gibt eine Farbe an, die den Mitarbeiter darstellt. Die Farbe entspricht der Farbpalette auf der Seite "Mitarbeiterdetails" in der Bookings-App.
createdDateTime	DateTimeOffset	Das Datum, die Uhrzeit und die Zeitzone, in der der Mitarbeiter erstellt wurde.
displayName	String	Der Name des Mitarbeiters, wie er den Kunden angezeigt wird. Erforderlich.
emailAddress	String	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	String	Die ID des Mitarbeiters im GUID-Format. Schreibgeschützt.
isEmailNotificationEnabled	Boolesch	Gibt an, dass Mitarbeiter per E-Mail benachrichtigt werden, wenn eine ihnen zugewiesene Buchung erstellt oder geändert wird. Der Standardwert ist true
lastUpdatedDateTime	DateTimeOffset	Datum, Uhrzeit und Zeitzone der letzten Aktualisierung des Mitarbeiters.
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	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

Der folgende JSON-Code ist eine Darstellung der 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)"
}