bookingstaffmember の更新

名前空間: microsoft.graph

指定した bookingBusiness で bookingStaffMember の プロパティを更新します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	Bookings.ReadWrite.All, Bookings.Manage.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	サポートされていません。

HTTP 要求

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

要求ヘッダー

名前	説明
Authorization	ベアラー {code}。 必須です。

要求本文

要求本文では、更新する必要があるプロパティの値 のみ を指定します。要求本文に含まれていない既存のプロパティは、以前の値を保持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

プロパティ	種類	説明
availabilityIsAffectedByPersonalCalendar	Boolean	True を指定すると、スタッフ メンバーが Microsoft 365 ユーザーである場合、Microsoft Bookings API は Microsoft 365 のスタッフ メンバーの個人用予定表と workingHours プロパティを使用して可用性を判断します。
displayName	文字列	顧客に表示されるスタッフ メンバーの名前。
emailAddress	String	スタッフ メンバーの電子メール アドレス。 これは、ビジネスと同じMicrosoft 365、または別の電子メール ドメインに含まれる場合があります。 この電子メール アドレスは 、sendConfirmationsToOwner プロパティがビジネスのスケジュール ポリシーで true 設定されている場合に使用されます。
role	string	ビジネスのスタッフ メンバーの役割。 使用可能な値: guest、administrator、viewer、externalGuest。
timeZone	String	スタッフ メンバーのタイム ゾーン。 使用できる値の一覧については 、「dateTimeTimeZone」を参照してください。
useBusinessHours	Boolean	True は、スタッフ メンバーの空き時間がビジネスの businessHours プロパティによって決まるという意味です。 False は、スタッフ メンバーの workingHouse プロパティ設定によって可用性が決定されます。
workingHours	bookingWorkHours コレクション	スタッフメンバーが予約可能な週の各日の時間の範囲。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。応答本文には何も返されません。

例

要求

次の使用例は、スタッフ メンバーのスケジュールを月曜日にオフに変更します。

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"
                }
            ]
        }
    ]
}

応答

応答の例を次に示します。

HTTP/1.1 204 No Content