bookingstaffmember aktualisieren

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Aktualisieren Sie die Eigenschaften eines bookingStaffMember-Objekts 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}

Optionale Anforderungsheader

Name Beschreibung
Authorization Bearer {code}. Erforderlich.

Anforderungstext

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. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Eigenschaft Typ Beschreibung
availabilityIsAffectedByPersonalCalendar Boolesch True bedeutet, dass, wenn der Mitarbeiter ein Microsoft 365 Benutzer ist, die Bookings-API den persönlichen Kalender des Mitarbeiters in Microsoft 365 sowie die eigenschaft workingHours verwendet, um die Verfügbarkeit zu ermitteln.
Colorindex Int32 Identifiziert eine Farbe, die den Mitarbeiter darstellt. Die Farbe entspricht der Farbpalette auf der Seite "Mitarbeiterdetails " in der Bookings-App.
displayName Zeichenfolge Der Name des Mitarbeiters, wie er den Kunden angezeigt wird.
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 auf "true" festgelegt ist.
isEmailNotificationEnabled Boolesch "True" bedeutet, dass mitarbeiter per E-Mail benachrichtigt werden, wenn eine ihm zugewiesene Buchung erstellt oder geändert wird.
role string Die Rolle des Mitarbeiters im Unternehmen. Mögliche Werte sind: guest, administrator, viewer, scheduler, member und externalGuest.
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 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 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 ist.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@contoso.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"
                }
            ]
        }
    ]
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content