bookingstaffmember を更新する

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

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

アクセス許可

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

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

HTTP 要求

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

オプションの要求ヘッダー

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

要求本文

要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。

プロパティ 種類 説明
availabilityIsAffectedByPersonalCalendar ブール型 True は、スタッフ メンバーがMicrosoft 365 ユーザーの場合、Bookings API は、Microsoft 365のスタッフ メンバーの個人用カレンダーと workingHours プロパティを使用して可用性を判断することを意味します。
colorIndex Int32 スタッフ メンバーを表す色を識別します。 色は、Bookings アプリの [スタッフの詳細 ] ページのカラー パレットに対応します。
displayName String 顧客に表示されるスタッフ メンバーの名前。
emailAddress String スタッフメンバーのメール アドレス。 これは、ビジネスと同じMicrosoft 365テナント内でも、別の電子メール ドメイン内でもかまいません。 この電子メール アドレスは、ビジネスのスケジュール ポリシーで sendConfirmationsToOwner プロパティが true に設定されている場合に使用されます。
isEmailNotificationEnabled ブール型 True の場合、割り当てられた予約が作成または変更されると、スタッフ メンバーに電子メールで通知されます。
role 文字列 ビジネスにおけるスタッフ メンバーの役割。 使用可能な値: guestadministratorviewerschedulermemberexternalGuest
timeZone String スタッフ メンバーのタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。
useBusinessHours ブール型 True は、スタッフ メンバーの可用性が、ビジネスの businessHours プロパティによって決定されていることを意味します。 False は、スタッフ メンバーの workingHouse プロパティ設定によって可用性が決定されていることを意味します。
workingHours bookingWorkHours コレクション スタッフメンバーが予約できる曜日ごとの時間の範囲。

応答

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

要求

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

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

応答

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

HTTP/1.1 204 No Content