Bookingservice を更新するUpdate bookingservice

名前空間: 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.

指定したbookingservicebookingserviceオブジェクトのプロパティを更新します。Update the properties of a bookingService object in the specified bookingbusiness.

以下に、サービスに対してカスタマイズできる例をいくつか示します。The following are some examples you can customize for a service:

  • PricePrice
  • 予定の通常の長さTypical length of an appointment
  • リマインダーReminders
  • サービスの実行前または完了後にセットアップする任意の時間バッファーAny time buffer to set up before or finish up after the service
  • 予約またはキャンセルするための最小限の通知や、ユーザーが予定に対して特定のスタッフメンバーを選択できるかどうかのスケジュールポリシーパラメーター。Scheduling policy parameters such as minimum notice to book or cancel, and whether customers can select specific staff members for an appointment.


この 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}/services/{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
defaultDurationdefaultDuration 期間Duration サービスの既定の長さ。日数、時間、分、および秒で表されます。The default length of the service, represented in numbers of days, hours, minutes, and seconds. たとえば、P11D23H59M 59.999999999999 S のようになります。For example, P11D23H59M59.999999999999S.
defaultLocationdefaultLocation locationlocation サービスの既定の物理的な場所。The default physical location for the service.
既定の価格defaultPrice DoubleDouble サービスの既定の通貨料金。The default monetary price for the service.
defaultPriceTypedefaultPriceType stringstring サービスの既定の課金方法。The default way the service is charged. 可能な値は、undefinedfixedPricestartingAthourlyfreepriceVariescallUsnotSet です。Possible values are: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet.
defaultRemindersdefaultReminders Bookingreminder コレクションbookingReminder collection このサービスの予定に対する既定のアラームのセット。The default set of reminders for an appointment of this service. このプロパティの値は、この Bookingservice を ID で読み取る場合にのみ使用できます。The value of this property is available only when reading this bookingService by its ID.
descriptiondescription StringString サービスのテキストの説明。A text description for the service.
displayNamedisplayName StringString サービス名。A service name.
emailAddressemailAddress StringString 電子メールアドレスAn email address
idid StringString 読み取り専用です。Read-only.
isHiddenFromCustomersisHiddenFromCustomers ブール値Boolean True は、このサービスを予約にお客様が利用できないことを意味します。True means this service is not available to customers for booking.
notesnotes StringString このサービスに関する追加情報。Additional information about this service.
postBufferpostBuffer 期間Duration このサービスの予定が終了してから、次の顧客の予定が予約されるまでの時間。The time to buffer after an appointment for this service ends, and before the next customer appointment can be booked.
preBufferpreBuffer 期間Duration このサービスの予定を開始できるようになるまでの時間。The time to buffer before an appointment for this service can start.
schedulingPolicyschedulingPolicy bookingSchedulingPolicybookingSchedulingPolicy この種類のサービスの予定を作成および管理する方法を決定する一連のポリシー。The set of policies that determine how appointments for this type of service should be created and managed.
staffMemberIdsstaffMemberIds String collectionString collection このサービスを提供する スタッフメンバー を表します。Represents those staff members who provide this service.


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



次の使用例は、指定されたサービスの期間を更新します。The following example updates the duration of the specified service.

Content-type: application/json


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

HTTP/1.1 204 No Content