bookingStaffMember-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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 ermitteln:

1. Standardmäßig stellen die Betriebsstunden des Unternehmens (die Eigenschaft "businessHours " der Entität "bookingBusiness ") die allgemeine Verfügbarkeit des Mitarbeiters dar.
2. Wenn useBusinessHours falsch ist, stellt die spezifische Arbeitszeit des Mitarbeiters (workingHours-Eigenschaft der bookingStaffmember-Entität ) die allgemeine Verfügbarkeit dieses Mitglieds dar.
3. Wenn "availabilityIsAffectedByPersonalCalendar " zutrifft, würde sich die Bookings-API zunächst die allgemein verfügbaren Stunden des Mitarbeiters ansehen (wie durch "#1" oder "#2" bestimmt), und die Verfügbarkeit während dieser Stunden im persönlichen Kalender des Mitarbeiters überprüfen, bevor eine Buchung ausgeführt 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 ein neues bookingStaffMember im angegebenen bookingbusiness.
bookingStaffMember abrufen	bookingStaffMember	Rufen Sie die Eigenschaften und Beziehungen eines bookingStaffMember im angegebenen bookingbusiness ab.
Update	Keine	Aktualisieren Sie die Eigenschaften eines bookingStaffMember im angegebenen bookingbusiness.
Delete	Keine	Löschen eines Mitarbeiters 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üfen würde, bevor eine Buchung ausgeführt wird.
Colorindex	Int32	Identifiziert eine Farbe, die den Mitarbeiter darstellt. Die Farbe entspricht der Farbpalette auf der Seite "Mitarbeiterdetails " in der Bookings-App.
displayName	Zeichenfolge	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 eigenschaft sendConfirmationsToOwner in der Terminplanungsrichtlinie des Unternehmens auf "true" festgelegt ist. Erforderlich.
id	Zeichenfolge	Die ID des Mitarbeiters in einem GUID-Format. Schreibgeschützt.
IsEmailNotificationEnabled	Boolesch	True bedeutet, dass mitarbeiter per E-Mail benachrichtigt werden, wenn eine ihm zugewiesene Buchung erstellt oder geändert wird.
role	bookingStaffRole	Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte sind: guest, administrator, viewer, externalGuest, unknownFutureValue``scheduler und member. Beachten Sie, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um die folgenden Werte in diesem [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations)Beispiel abzurufen: scheduler, member. 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 wie in der Eigenschaft "businessHours " des Unternehmens angegeben ist. False bedeutet, dass die Verfügbarkeit durch die Einstellung der workingHours-Eigenschaft des Mitarbeiters bestimmt wird.
workingHours	bookingWorkHours-Sammlung	Der Stundenbereich an jedem Tag der Woche, den der Mitarbeiter zur Buchung zur Verfügung steht. Standardmäßig werden sie so initialisiert, dass sie der Eigenschaft "businessHours " des Unternehmens entsprechen.

Beziehungen

Keine

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "availabilityIsAffectedByPersonalCalendar": true,
  "colorIndex": 1024,
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "useBusinessHours": true,
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}],
  "timeZone": "String",
  "IsEmailNotificationEnabled": "Boolean"
}