bookingStaffMember-Ressourcentyp

Namespace: microsoft.graph

Stellt einen Mitarbeiter dar, der Dienste in einem bookingBusiness-Objekt 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 Terminbuchung berücksichtigt die Bookings-API die folgenden Einstellungen, um die Verfügbarkeit eines Mitarbeiters zu bestimmen:

  1. Standardmäßig stellt die Betriebszeit des Unternehmens (die Eigenschaft "businessHours" der BookingBusiness-Entität) 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 die Bookings-API zunächst die allgemein verfügbaren Stunden des Mitarbeiters betrachten (wie durch Nr. 1 oder Nr. 2 bestimmt), und die Verfügbarkeit während dieser Stunden im persönlichen Kalender des Mitarbeiters überprüfen, bevor eine Buchung erfolgt.

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 Bookingbusinessab.
bookingStaff erstellen bookingStaffMember-Sammlung Erstellen Sie ein neues bookingStaffMember-Element im angegebenen Bookingbusiness.
bookingStaffMember abrufen bookingStaffMember Rufen Sie die Eigenschaften und Beziehungen eines bookingStaffMember im angegebenen Bookingbusinessab.
Update bookingStaffMember Aktualisieren sie die Eigenschaften von bookingStaffMember im angegebenen Bookingbusiness.
Löschen Keiner Löschen Sie einen Mitarbeiter im angegebenen Bookingbusiness.

Eigenschaften

Eigenschaft Typ Beschreibung
availabilityIsAffectedByPersonalCalendar Boolescher Wert True bedeutet, dass, wenn der Mitarbeiter ein Microsoft 365 Benutzer ist, die Bookings-API die Verfügbarkeit des Mitarbeiters in ihrem persönlichen Kalender in Microsoft 365 überprüfen würde, bevor eine Buchung erfolgt.
displayName Zeichenfolge Der Name des Mitarbeiters, wie den Kunden angezeigt. 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 Planungsrichtlinie des Unternehmens auf "true" festgelegt ist. Erforderlich.
id Zeichenfolge Die ID des Mitarbeiters in einem GUID-Format. Schreibgeschützt.
role bookingStaffRole Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte sind: guest , administrator , und viewer externalGuest unknownFutureValue . Erforderlich.
timeZone Zeichenfolge Die Zeitzone des Mitarbeiters. Eine Liste möglicher Werte finden Sie unter dateTimeTimeZone.
useBusinessHours Boolescher Wert True bedeutet, dass die Verfügbarkeit des Mitarbeiters 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 für die 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,
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "useBusinessHours": true,
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}],
  "timeZone": "String"
}