Bookingstaffmember aktualisierenUpdate bookingstaffmember

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.

Aktualisieren der Eigenschaften eines bookingStaffMember in der angegebenen bookingbusiness.Update the properties of a bookingStaffMember in the specified bookingbusiness.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Reservierungen. ReadWrite. all, reservations. Manage. allBookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

PATCH /bookingBusinesses/{id}/staffMembers/{id}

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}Bearer {code}

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
availabilityIsAffectedByPersonalCalendaravailabilityIsAffectedByPersonalCalendar BooleanBoolean True bedeutet, dass die Buchungs-API, wenn der Mitarbeiter ein Office 365er Benutzer ist, den persönlichen Kalender des Mitarbeiters in Office 365 sowie die workingHours -Eigenschaft verwendet, um die Verfügbarkeit zu bestimmen.True means that if the staff member is an Office 365 user, the Bookings API uses the staff member's personal calendar in Office 365 as well as the workingHours property to determine availability.
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.
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 wird verwendet, wenn die sendConfirmationsToOwner -Eigenschaft in der Planungsrichtlinie des Unternehmens auf true festgelegt ist.This email address is used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business.
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.
useBusinessHoursuseBusinessHours BooleanBoolean True bedeutet, dass die Verfügbarkeit des Mitarbeiters von der businessHours -Eigenschaft des Unternehmens bestimmt wird.True means the staff member's availability is determined by the businessHours property of the business. False bedeutet, dass die Verfügbarkeit von der Einstellung der workingHouse -Eigenschaft des Mitarbeiters bestimmt wird.False means the availability is determined by the staff member's workingHouse 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.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No content zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns a 204 No content response code. It does not return anything in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel wird der Zeitplan des Mitarbeiters so geändert, dass er montags deaktiviert ist.The following example changes the staff member's schedule to have Mondays off.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@M365B489948.onmicrosoft.com/staffmembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json

{
    "workingHours":[
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"monday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[

            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"tuesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"wednesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"thursday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"friday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        }
    ]
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No Content