bookingStaffMember-RessourcentypbookingStaffMember resource type

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.

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

Mitarbeiter können Teil des Office 355-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 Office 355 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 in der persönlichen Person des Mitarbeiters überprüfen. Kalender, bevor Sie eine Buchung vornehmen.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.
DeleteDelete KeinerNone 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 die Reservierungs-API, wenn der Mitarbeiter ein Office 365er Benutzer ist, die Verfügbarkeit des Mitarbeiters in seinem persönlichen Kalender in Office 365 überprüft, bevor er eine Buchung tätigt.True means that if the staff member is an Office 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Office 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. Dies kann sich in demselben Office 365 Mandanten wie das Unternehmen oder in einer anderen e-Mail-Domäne befinden.This can be in the same Office 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 StringString Die ID des Mitarbeiter Elements in einem GUID-Format.The ID of the staff member, in a GUID format. Schreibgeschützt.Read-only.
rolerole stringstring Die Rolle des Mitarbeiters im Unternehmen.The role of the staff member in the business. Mögliche Werte: guest, administrator, viewer, externalGuest.Possible 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"}]
}