次の方法で共有

Bookingservice を更新する

  • [アーティクル]

名前空間: microsoft.graph

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

サービス用にカスタマイズできる例を次に示します。

  • Price
  • 予定の一般的な長さ
  • リマインダー
  • サービスの前または後に設定する任意の時間バッファー
  • 予約またはキャンセルの最小通知、顧客が予定の特定のスタッフ メンバーを選択できるかどうかを示すスケジュール ポリシー パラメーター。

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

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

アクセス許可

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

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

HTTP 要求

PATCH /solutions/bookingBusinesses/{id}/services/{id}

要求ヘッダー

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

要求本文

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

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

プロパティ 型 説明
customQuestions bookingQuestionAssignment コレクション これには、特定のサービスに関連付けられている一連のカスタム質問が含まれます。 省略可能。
defaultDuration 期間 日数、時間、分、秒で表されるサービスの既定の長さ。 たとえば、P11D23H59M59.9999999999999S です。
defaultLocation location サービスの既定の物理的な場所。
defaultPrice 倍精度浮動小数点数 サービスの既定の金額。
defaultPriceType bookingPriceType サービスが課金される既定の方法。 可能な値は、undefined、fixedPrice、startingAt、hourly、free、priceVaries、callUs、notSet、unknownFutureValue です。
defaultReminders bookingReminder コレクション このサービスの予定に対するアラームの既定のセット。 このプロパティの値は、この BookingService を ID で読み取る場合にのみ使用できます。
説明 String サービスのテキストの説明。
displayName String サービス名。
id String BookingService の一意の識別子。 読み取り専用です。
isAnonymousJoinEnabled ブール型 True このサービスで予約された予定に対して、匿名で予定に参加する URL (anonymousJoinWebUrl) が生成される場合。
isCustomerAllowedToManageBooking ブール型 顧客がスタッフによって作成された予約を管理できることを示します。 既定値は false です。
isHiddenFromCustomers ブール型 True は、予約のためにサービスを顧客が利用できないことを示します。
isLocationOnline ブール型 True は、サービスの予定がオンラインで開催されることを示します。 既定値は false です。
languageTag String セルフサービス予約ページの言語。
maximumAttendeesCount Int32 サービスで許可される顧客の最大数。
notes String このサービスに関する追加情報。
postBuffer 期間 このサービスの予定が終了した後、次の顧客の予定を予約する前にバッファーする時間。
preBuffer 期間 このサービスの予定が開始されるまでのバッファー処理時間。
scheduleingPolicy bookingSchedulingPolicy この種類のサービスの予定を作成および管理する方法を決定するポリシーのセット。
smsNotificationsEnabled ブール型 True は、サービスの予定について SMS 通知を顧客に送信できることを示します。 既定値は false です。
staffMemberIds String collection このサービスを提供する スタッフ メンバー を表します。

応答

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

例

要求

次の例では、指定したサービスの期間を更新します。

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingService",
    "defaultDuration":"PT30M"
}

応答

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

HTTP/1.1 204 No Content