Bookingstaffmember の更新Update bookingstaffmember

名前空間: microsoft.graphNamespace: microsoft.graph

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

指定したbookingbusinessbookingStaffMemberのプロパティを更新します。Update the properties of a bookingStaffMember in the specified bookingbusiness.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) 予約します。すべての予約Bookings.ReadWrite.All, Bookings.Manage.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication サポートされていません。Not supported.

HTTP 要求HTTP request

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

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

名前Name 説明Description
AuthorizationAuthorization Bearer {code}Bearer {code}

要求本文Request body

要求本文で、更新する関連フィールドの値を指定します。要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

プロパティProperty 種類Type 説明Description
availabilityIsAffectedByPersonalCalendaravailabilityIsAffectedByPersonalCalendar ブール型Boolean True は、スタッフメンバーが Microsoft 365 ユーザーである場合、予約 API は、Microsoft 365 のスタッフメンバーの個人用予定表と workingHours プロパティを使用して、可用性を判断します。True means that if the staff member is a Microsoft 365 user, the Bookings API uses the staff member's personal calendar in Microsoft 365 as well as the workingHours property to determine availability.
colorIndexcolorIndex Int32Int32 スタッフメンバーを表す色を識別します。Identifies a color to represent the staff member. この色は、予約アプリの [ スタッフの詳細 ] ページのカラーパレットに対応しています。The color corresponds to the color palette in the Staff details page in the Bookings app.
displayNamedisplayName 文字列String スタッフメンバーの名前。顧客に表示されます。The name of the staff member, as displayed to customers.
emailAddressemailAddress StringString スタッフメンバーの電子メールアドレス。The email address of the staff member. これは、ビジネスと同じ Microsoft 365 テナントまたは別の電子メールドメインに配置できます。This can be in the same Microsoft 365 tenant as the business, or in a different email domain. この電子メールアドレスは、ビジネスのスケジューリングポリシーで sendConfirmationsToOwner プロパティが true に設定されている場合に使用されます。This email address is used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business.
rolerole stringstring 業務のスタッフメンバーの役割。The role of the staff member in the business. 使用可能な値は、guestadministratorviewerexternalGuest です。Possible values are: guest, administrator, viewer, externalGuest.
useBusinessHoursuseBusinessHours ブール型Boolean True は、スタッフメンバーの利用可能性がビジネスの microsoft.rtc.rgs.management.writablesettings.businesshours プロパティによって決定されることを意味します。True means the staff member's availability is determined by the businessHours property of the business. False は、可用性がスタッフメンバーの workingHouse プロパティの設定によって決定されることを意味します。False means the availability is determined by the staff member's workingHouse property setting.
workingHoursworkingHours Bookingwork hours コレクションbookingWorkHours collection スタッフメンバーが予約に使用できる各曜日の時間の範囲。The range of hours each day of the week that the staff member is available for booking.

応答Response

成功した場合、このメソッドは 204 No content 応答コードを返します。応答本文には何も返されません。If successful, this method returns a 204 No content response code. It does not return anything in the response body.

Example

要求Request

次の例では、スタッフメンバーのスケジュールを変更して月曜日をオフにします。The following example changes the staff member's schedule to have Mondays off.

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

応答の例を次に示します。The following is an example of the response.

HTTP/1.1 204 No Content