Bookingservice を更新する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
指定した 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}。 必須です。 |
要求本文
要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。
プロパティ | 型 | 説明 |
---|---|---|
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 | 読み取り専用。 |
isAnonymousJoinEnabled | ブール型 | True このサービスで予約された予定に対して、匿名で予定に参加する URL (anonymousJoinWebUrl) が生成される場合。 |
isCustomerAllowedToManageBooking | ブール型 | 顧客がスタッフによって作成された予約を管理できることを示します。 既定値は false です。 |
isHiddenFromCustomers | ブール型 | True は、このサービスを予約のお客様が利用できないことを意味します。 |
isLocationOnline | ブール型 | True は、サービスの予定がオンラインで開催されることを示します。 既定値は false です。 |
languageTag | String | セルフサービス予約ページの言語。 |
notes | String | このサービスに関する追加情報。 |
postBuffer | 期間 | このサービスの予定が終了した後、次の顧客の予定を予約する前にバッファーする時間。 |
preBuffer | 期間 | このサービスの予定が開始されるまでのバッファー処理時間。 |
scheduleingPolicy | bookingSchedulingPolicy | この種類のサービスの予定を作成および管理する方法を決定するポリシーのセット。 |
smsNotificationsEnabled | ブール型 | True は、サービスの予定に対して SMS 通知を顧客に送信できることを示します。 既定値は false です。 |
staffMemberIds | String collection | このサービスを提供する スタッフ メンバー を表します。 |
customQuestions | bookingQuestionAssignment コレクション | これには、特定のサービスに関連付けられている一連のカスタム質問が含まれます。 省略可能です。 |
maximumAttendeesCount | Int32 | サービスで許可される顧客の最大数。 |
応答
成功した場合、このメソッドは 204 No content
応答コードを返します。 応答本文では何も返されません。
例
要求
次の例では、指定したサービスの期間を更新します。
PATCH https://graph.microsoft.com/beta/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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示