BookingAppointment を更新する

名前空間: microsoft.graph

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

この API は、次の国内クラウド展開で使用できます。

グローバル サービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

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

注:

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

HTTP 要求

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

要求ヘッダー

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

要求本文

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

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

プロパティ	型	説明
customerEmailAddress	String	予約を予約する BookingCustomer の SMTP アドレス。
customerName	String	顧客の名前。
customerNotes	String	この予定に関連付けられている顧客からのメモ。 値は、この BookingAppointment を ID で読み取った場合にのみ取得できます。 このプロパティは、最初に新しい顧客との予定を作成する場合にのみ設定できます。
customerPhone	String	顧客の電話番号。
顧客	bookingCustomerInformation コレクション	予定の顧客プロパティが一覧表示されます。 予定には顧客情報の一覧が含まれており、各ユニットは、その予定の一部である顧客のプロパティを示します。 省略可能。
customerTimeZone	String	顧客のタイム ゾーン。 使用可能な値の一覧については、「 dateTimeTimeZone」を参照してください。
duration	期間	ISO8601形式で示される予定の長さ。
end	dateTimeTimeZone	予定が終了する日付、時刻、タイム ゾーン。
invoiceStatus	string	請求書の状態。 使用可能な値は、 draft、 reviewing、 open、 canceled、 paid、および correctiveです。
isCustomerAllowedToManageBooking	ブール型	顧客がスタッフによって作成された予約を管理できることを示します。 既定値は false です。
filledAttendeesCount	Int32	予定内の顧客の現在の数。 必須です。
isLocationOnline	ブール型	True は、予定がオンラインで開催されることを示します。 既定値は false です。
maximumAttendeesCount	Int32	予定で許可される顧客の最大数。 必須です。
optOutOfCustomerEmail	ブール型	True は、この予定の BookingCustomer がこの予定の確認を受け取りたくないことを示します。
postBuffer	期間	たとえば、予定が終了した後に予約する時間です。クリーンアップのために使用します。 値は 、ISO8601 形式で表されます。
preBuffer	期間	たとえば、準備のために予定が開始されるまでに予約する時間。 値は 、ISO8601 形式で表されます。
価格	倍精度浮動小数点数	指定した BookingService の予定の通常価格。
priceType	bookingPriceType	サービスの価格構造に柔軟性を提供する設定。 可能な値は、undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue です。
アラーム	bookingReminder コレクション	この予定に送信された顧客リマインダーのコレクション。 このプロパティの値は、この BookingAppointment を ID で読み取る場合にのみ使用できます。
selfServiceAppointmentId	String	予定のもう 1 つの追跡 ID。予定がスケジュール ページで顧客によって直接作成された場合、顧客の代わりにスタッフ メンバーが作成した場合。
serviceId	String	この予定に関連付けられている BookingService の ID。
serviceLocation	location	サービスが配信される場所。
serviceName	String	この予定に関連付けられている BookingService の名前。 このプロパティは、新しい予定を作成するときに省略可能です。 指定しない場合は、 serviceId プロパティによって予定に関連付けられているサービスから計算されます。
serviceNotes	String	BookingStaffMember からのメモ。 このプロパティの値は、この BookingAppointment を ID で読み取る場合にのみ使用できます。
smsNotificationsEnabled	ブール型	True は、SMS 通知が予定の顧客に送信されることを示します。 既定値は false です。
staffMemberIds	String collection	この予定でスケジュールされている各 BookingStaffMember の ID。
開始	dateTimeTimeZone	予定が開始される日付、時刻、タイム ゾーン。

注:

サービスで許可されている顧客の最大数 (maximumAttedeesCount) が 1 を超える場合:

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

応答

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

例

要求

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

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

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

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content