bookingstaffmember aktualisieren

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften eines bookingStaffMember in der angegebenen bookingBusiness.Update the properties of a bookingStaffMember in the specified bookingBusiness.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Bookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

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

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften 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.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft	Typ	Beschreibung
availabilityIsAffectedByPersonalCalendar	Boolesch	True bedeutet, dass, wenn der Mitarbeiter ein Microsoft 365-Benutzer ist, die Microsoft Bookings-API den persönlichen Kalender des Mitarbeiters in Microsoft 365 sowie die workingHours-Eigenschaft verwendet, um die Verfügbarkeit zu bestimmen.
displayName	Zeichenfolge	Der Name des Mitarbeiters, wie er den Kunden angezeigt wird.
emailAddress	Zeichenfolge	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 wird verwendet, wenn die sendConfirmationsToOwner-Eigenschaft in der Planungsrichtlinie des Unternehmens auf true festgelegt ist.
isEmailNotificationEnabled	Boolesch	True gibt an, dass ein Mitarbeiter per E-Mail benachrichtigt wird, wenn eine ihm zugewiesene Buchung erstellt oder geändert wird.
role	bookingStaffRole	Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember.
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 durch die businessHours-Eigenschaft des Unternehmens bestimmt wird. False bedeutet, dass die Verfügbarkeit durch die WorkingHouse-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.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.

Beispiel

Anforderung

Im folgenden Beispiel wird der Zeitplan des Mitarbeiters so geändert, dass montags deaktiviert sind.

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

{
    "@odata.type":"#microsoft.graph.bookingStaffMember",
    "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",
                    "endTime":"17:00:00.0000000",
                    "startTime":"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",
                    "endTime":"17:00:00.0000000",
                    "startTime":"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",
                    "endTime":"17:00:00.0000000",
                    "startTime":"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",
                    "endTime":"17:00:00.0000000",
                    "startTime":"08:00:00.0000000"
                }
            ]
        }
    ]
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content