Freigeben über


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
List bookingStaffMember-Sammlung Ruft eine Liste der bookingStaffMember-Objekte im angegebenen bookingBusiness ab.
Create bookingStaffMember-Sammlung Create im angegebenen bookingBusiness einen neuen bookingStaffMember.
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.
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 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 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 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

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)"
}