bookingStaffMember-RessourcentypbookingStaffMember resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.

Stellt einen Mitarbeiter dar, der Dienste in einer bookingBusinessbereitstellt.Represents a staff member who provides services in a bookingBusiness.

Mitarbeiter können Teil des Microsoft 365-Mandanten sein, in dem das Buchungs Geschäft konfiguriert ist, oder Sie können e-Mail-Dienste von anderen e-Mail-Anbietern verwenden.Staff members can be part of the Microsoft 365 tenant where the booking business is configured, or they can use email services from other email providers.

Bei der Buchung von Terminen berücksichtigt die Buchungs-API die folgenden Einstellungen, um die Verfügbarkeit eines Mitarbeiters zu ermitteln:When booking appointments, the Bookings API considers the following settings to determine a staff member's availability:

  1. Standardmäßig stellt die Betriebsstunden des Unternehmens (die businessHours -Eigenschaft der bookingBusiness -Entität) die allgemeine Verfügbarkeit des Mitarbeiters dar.By default, the hours of operation of the business (the businessHours property of the bookingBusiness entity) represents the general availability of the staff member.
  2. Wenn useBusinessHours auf false festgelegt ist, stellt die spezifische Arbeitszeit des Mitarbeiters (workingHours -Eigenschaft der bookingStaffmember -Entität) die allgemeine Verfügbarkeit dieses Members dar.If useBusinessHours is false, then the staff member's specific work hours (workingHours property of the bookingStaffmember entity) represents that member's general availability.
  3. Wenn availabilityIsAffectedByPersonalCalendar auf true festgelegt ist, würde die Buchungs-API zunächst die allgemein verfügbaren Stunden des Mitarbeiters betrachten (je nach #1 oder #2) und die Verfügbarkeit während dieser Stunden im persönlichen Kalender des Mitarbeiters vor der Buchung überprüfen.If availabilityIsAffectedByPersonalCalendar is true, then the Bookings API would first look at the staff member's generally available hours (as determined by either #1 or #2), and verify availability during those hours in the staff member's personal calendar, before making a booking.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Personalmitglieder auflistenList staff members bookingStaffMember -SammlungbookingStaffMember collection Rufen Sie eine Liste der bookingStaffMember -Objekte im angegebenen bookingbusiness-Objekt ab.Get a list of bookingStaffMember objects in the specified bookingbusiness.
BookingStaff erstellenCreate bookingStaff bookingStaffMember -SammlungbookingStaffMember collection Erstellen Sie eine neue bookingStaffMember im angegebenen bookingbusiness.Create a new bookingStaffMember in the specified bookingbusiness.
BookingStaffMember abrufenGet bookingStaffMember bookingStaffMemberbookingStaffMember Rufen Sie die Eigenschaften und Beziehungen eines bookingStaffMember im angegebenen bookingbusinessab.Get the properties and relationships of a bookingStaffMember in the specified bookingbusiness.
UpdateUpdate bookingStaffMemberbookingStaffMember Aktualisieren der Eigenschaften eines bookingStaffMember in der angegebenen bookingbusiness.Update the properties of a bookingStaffMember in the specified bookingbusiness.
LöschenDelete KeineNone Löschen Sie einen Mitarbeiter im angegebenen bookingbusiness-Element.Delete a staff member in the specified bookingbusiness.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
availabilityIsAffectedByPersonalCalendaravailabilityIsAffectedByPersonalCalendar BooleschBoolean True bedeutet, dass wenn der Mitarbeiter ein Microsoft 365-Benutzer ist, die Buchungs-API die Verfügbarkeit des Mitarbeiters in seinem persönlichen Kalender in Microsoft 365 überprüfen würde, bevor er eine Buchung tätigt.True means that if the staff member is a Microsoft 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Microsoft 365, before making a booking.
ColorIndexcolorIndex Int32Int32 Gibt eine Farbe zur Darstellung des Mitarbeiter-Members an.Identifies a color to represent the staff member. Die Farbe entspricht der Farbpalette auf der Seite " Mitarbeiterdetails " in der App "Buchungen".The color corresponds to the color palette in the Staff details page in the Bookings app.
displayNamedisplayName ZeichenfolgeString Der Name des Mitarbeiters, wie er für Kunden angezeigt wird.The name of the staff member, as displayed to customers. Erforderlich.Required.
emailAddressemailAddress StringString Die e-Mail-Adresse des Mitarbeiter Mitglieds.The email address of the staff member. Dieser kann sich in demselben Microsoft 365-Mandanten wie das Unternehmen oder in einer anderen e-Mail-Domäne befinden.This can be in the same Microsoft 365 tenant as the business, or in a different email domain. Diese e-Mail-Adresse kann verwendet werden, wenn die sendConfirmationsToOwner -Eigenschaft in der Planungsrichtlinie des Unternehmens auf true festgelegt ist.This email address can be used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business. Erforderlich.Required.
idid ZeichenfolgeString Die ID des Mitarbeiter Elements in einem GUID-Format.The ID of the staff member, in a GUID format. Schreibgeschützt.Read-only.
rolerole Zeichenfolgestring Die Rolle des Mitarbeiters im Unternehmen.The role of the staff member in the business. Mögliche Werte: guest, administrator, viewer, externalGuestPossible values are: guest, administrator, viewer, externalGuest. Erforderlich.Required.
useBusinessHoursuseBusinessHours BooleschBoolean True bedeutet, dass die Verfügbarkeit des Mitarbeiters wie in der businessHours -Eigenschaft des Unternehmens angegeben ist.True means the staff member's availability is as specified in the businessHours property of the business. False bedeutet, dass die Verfügbarkeit von der Einstellung der workingHours -Eigenschaft des Mitarbeiters bestimmt wird.False means the availability is determined by the staff member's workingHours property setting.
workingHoursworkingHours bookingWorkHours -SammlungbookingWorkHours collection Der Stundenbereich an jedem Wochentag, an dem der Mitarbeiter für die Buchung zur Verfügung steht.The range of hours each day of the week that the staff member is available for booking. Standardmäßig werden Sie mit der businessHours -Eigenschaft des Unternehmens initialisiert.By default, they are initialized to be the same as the businessHours property of the business.

BeziehungenRelationships

KeineNone

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

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