Bookingstaffmember aktualisieren

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines bookingStaffMember im angegebenen bookingBusiness- Objekt.

Berechtigungen

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.

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 /bookingBusinesses/{id}/staffMembers/{id}

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}. Erforderlich.

Anforderungstext

Stellen Sie im Anforderungstext nur die Werte für Eigenschaften bereit, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei 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 den Kunden angezeigt.
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 wird verwendet, wenn die Eigenschaft "sendConfirmationsToOwner" in der Planungsrichtlinie des Unternehmens festgelegt true ist.
role	Zeichenfolge	Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte: guest, administrator, viewer, externalGuest
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 durch die Eigenschaft "businessHours" des Unternehmens bestimmt wird. False bedeutet, dass die Verfügbarkeit durch die Einstellung der WorkingHouse-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.

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 ausgeschaltet ist.

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