bookingAppointment を更新する

名前空間: microsoft.graph

指定した bookingBusiness 内の bookingAppointment オブジェクトのプロパティを更新します。

アクセス許可

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

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

注意

アプリケーションのアクセス許可を使用してカスタム アプリを作成する場合は、 ビジネス ルールの検証に従う必要があります。

HTTP 要求

PATCH /solutions/bookingBusinesses/{id}/appointments/{id}

要求ヘッダー

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

要求本文

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

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

プロパティ	型	説明
顧客	bookingCustomerInformation コレクション	予定の顧客プロパティが一覧表示されます。 予定には顧客情報の一覧が含まれており、各ユニットはその予定の一部である顧客のプロパティを示します。 省略可能。
customerTimeZone	String	顧客のタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。
duration	期間	ISO8601 形式で示される予定の長さ。
endDateTime	dateTimeTimeZone	予定が終了する日付、時刻、タイム ゾーン。
filledAttendeesCount	Int32	予定の現在の顧客数。 必須です。
isLocationOnline	Boolean	場合 trueは、予定がオンラインで保持されることを示します。 既定値は False です。
maximumAttendeesCount	Int32	予定で許可される顧客の最大数。 必須です。
optOutOfCustomerEmail	Boolean	場合 trueは、この予定の bookingCustomer がこの予定の確認を受け取りたくないことを示します。
postBuffer	期間	例として、予定が終了した後に予約する時間 (クリーンアップ用) を指定します。 値は ISO8601 形式で表されます。
preBuffer	期間	準備のために、予定が開始される前に予約する時間を例に示します。 値は ISO8601 形式で表されます。
価格	倍精度浮動小数点数	指定した bookingService の予定の通常価格。
priceType	bookingPriceType	サービスの価格構造に柔軟性を提供する設定。 可能な値は、undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue です。
アラーム	bookingReminder コレクション	この予定に対して送信された顧客のリマインダーのコレクション。 このプロパティの値は、ID でこの bookingAppointment を 読み取る場合にのみ使用できます。
selfServiceAppointmentId	String	顧客に代わってスタッフが行うのではなく、スケジュール 設定ページで顧客によって直接予定が作成された場合は、予定の追加の追跡 ID。 maxAttendeeCount が 1 の場合にのみ、予定に対してサポートされます。
serviceId	String	この予定に関連付けられている bookingService の ID。
serviceLocation	location	サービスが配信される場所。
serviceName	String	この予定に関連付けられている bookingService の名前。 このプロパティは、新しい予定を作成するときに省略可能です。 指定しない場合は、予定に関連付けられているサービスから serviceId プロパティによって計算されます。
serviceNotes	String	bookingStaffMember からのメモ。 このプロパティの値は、ID でこの bookingAppointment を 読み取る場合にのみ使用できます。
smsNotificationsEnabled	Boolean	場合 trueは、予定の顧客に SMS 通知が送信されることを示します。 既定値は False です。
staffMemberIds	String collection	この予定でスケジュールされている各 bookingStaffMember の ID。
startDateTime	dateTimeTimeZone	予定が開始される日付、時刻、タイム ゾーン。

注意

サービスで許可される顧客の最大数 (maximumAttedeesCount) が 1 より大きい場合:

• Booking Calendar に顧客が存在することを確認します。 作成しない場合は、 BookingCustomer の作成操作を 使用して作成します。
• 予定を作成または更新するときに、有効な顧客 ID を渡します。 顧客 ID が無効な場合、その顧客は予定オブジェクトに含まれません。

応答

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

例

要求

次の例では、サービスの日付を 1 日ずつ変更します。

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/appointments/AAMkADKnAAA=
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingAppointment",
    "endDateTime":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "startDateTime":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:00:00.0000000+00:00",
        "timeZone":"UTC"
    }
}

応答

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

HTTP/1.1 204 No Content