---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD Multi Reservation API

# WSD Multi Reservation API {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：33分

ワークプレイスサービスデリバリ (WSD) Multi Reservation API は、複数の職場の場所を含む予約を管理するためのエンドポイントを提供します。
この API にアクセスするには、問い合わせユーザーに sn_wsd_core.workplace_user ロールが必要であり、Workplace Safety Management (sn_wsd_core) と Workplace Reservation Management (sn_wsd_rsv) プラグインを有効にする必要があります。

この API は `sn_wsd_rsv` 名前空間で実行されます。

ワークプレイス予約管理の詳細については、「[ワークプレイス予約管理](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。

## WSD Multi Reservation - PATCH /api/sn_wsd_rsv/multi_reservation/cancel/{sys_id} {#ariaid-title2}

指定された複数予約をキャンセルします。
<br />

### URL 形式

バージョニングされている URL：/api/sn_wsd_rsv/{api_version}/multi_reservation/cancel/{sys_id}

デフォルトの URL：/api/sn_wsd_rsv/multi_reservation/cancel/{sys_id}

### サポートされている要求パラメーター

{#wsd_multi_reserv-PATCH-cancel__entry__2}{#wsd_multi_reserv-PATCH-cancel__version-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | キャンセルする複数予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#wsd_multi_reserv-PATCH-cancel__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 2. クエリパラメーター]

{#wsd_multi_reserv-PATCH-cancel__entry__12}

| 名前 | 説明 |
|-|-|
| cancel_notes | 予約をキャンセルする理由 データタイプ：文字列 |
[表 : 3. 要求本文パラメーター]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-PATCH-cancel__entry__16}{#wsd_multi_reserv-PATCH-cancel__accept-reserv-entry}{#wsd_multi_reserv-PATCH-cancel__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 要求本文のデータ形式。サポートされるタイプ：application/json、application/xml、または text/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 4. 要求ヘッダー]

{#wsd_multi_reserv-PATCH-cancel__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-PATCH-cancel__entry__26}{#wsd_multi_reserv-PATCH-cancel__entry-200-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-401-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-404-status-code}{#wsd_multi_reserv-PATCH-cancel__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター

{#wsd_multi_reserv-PATCH-cancel__entry__36}{#wsd_multi_reserv-PATCH-cancel__parent-multi-entry}

| 名前 | 説明 |
|-|-|
| result | キャンセル要求の結果の詳細。 データタイプ：オブジェクト "result": { "error": "String", "parent": "String", "success": Boolean, "successfulReservations": [Array], "unSuccessfulReservations": [Array] } |
| result.error | 関連するエラーを説明するメッセージ。 データタイプ：文字列 |
| result.parent | 親予約の sys_id。親には、1 つ以上の子予約を関連付けることができます。 データタイプ：文字列 |
| result.success | 予約が正常にキャンセルされたかどうかを示すフラグ。 可能な値： * true：正常にキャンセルされました。 * false：予約はキャンセルされませんでした。 データタイプ：ブーリアン |
| result.successfulReservations | 複数予約の正常なキャンセルに関する詳細。 データタイプ：オブジェクトのアレイ "successfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.successfulReservations.msg | キャンセルメッセージ。 データタイプ：文字列 |
| result.successfulReservations.success | 予約が正常にキャンセルされたかどうかを示すフラグ。 可能な値： * true：正常にキャンセルされました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations.sys_id | キャンセルされた予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 データタイプ：文字列 |
| result.unSuccessfulReservations | 正常にキャンセルされなかった複数予約に関する詳細。 データタイプ：オブジェクトのアレイ "unSuccessfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.unSuccessfulReservations.msg | キャンセルメッセージ。 データタイプ：文字列 |
| result.unSuccessfulReservations.success | 予約が正常にキャンセルされたかどうかを示すフラグ。 可能な値： * true：正常にキャンセルされました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.unSuccessfulReservations.sys_id | キャンセルされなかった予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 データタイプ：文字列 |
[ ]

### cURL 要求

次のコード例は、複数予約をキャンセルする方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/cancel/1b1fdf5987ab01506342b846dabb35ec" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"cancel_notes\":\"Meeting no longer needed.\"}" \ 
    --user "username":"password'"

返される結果：

    {
      "result": {
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "msg": "Cancelled successfully.",
            "sys_id": "5b1f9f1d87ab01506342b846dabb35a4"
          },
          {
            "success": true,
            "msg": "Cancelled successfully.",
            "sys_id": "931f9f1d87ab01506342b846dabb35a0"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null,
        "parent": "1b1fdf5987ab01506342b846dabb35ec"
      }
    }

## WSD Multi Reservation - PATCH /api/sn_wsd_rsv/multi_reservation/update/{sys_id} {#ariaid-title3}

同じ予約 (会議) に複数の職場の場所がある複数予約に関連付けられている予約を更新します。
このエンドポイントは、次の 4 つの異なる更新シナリオを処理できます。

1. 件名、日付、時刻などの複数の予約レコードの内容を更新します。
2. 複数予約を親 (単一の職場の場所に対する予約) に基づいて単一予約に変換します。
3. 単一予約 (単一の職場の場所に対する予約) を複数予約に変換します。
4. 職場の場所を既存の複数予約に追加または複数予約から削除します。

### URL 形式

バージョニングされている URL：/api/sn_wsd_rsv/{api_version}/multi_reservation/update/{sys_id}

デフォルトの URL：/api/sn_wsd_rsv/multi_reservation/update/{sys_id}

### サポートされている要求パラメーター

{#wsd_multi_reserv-PATCH-update__entry__2}{#wsd_multi_reserv-PATCH-update__version-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | 更新する予約の sys_id。 * 単一予約から複数予約：単一予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 * 複数予約のコンテンツを更新：親予約レコードの sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 子レコードから複数の親予約の詳細を取得するには、子レコードの \[source_reservation\] フィールドで sys_id を参照します。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#wsd_multi_reserv-PATCH-update__entry__8}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 8. クエリパラメーター]

{#wsd_multi_reserv-PATCH-update__entry__12}{#wsd_multi_reserv-PATCH-update__end-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__requested_for-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__reservable_module-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__shift-update_reserv-entry}{#wsd_multi_reserv-PATCH-update__start-update_reserv-entry}

| 名前 | 説明 |
|-|-|
| 終了 | shiftパラメーターが渡されない場合は必須です。予約の要求された終了時間。 データタイプ：文字列 形式：UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| requested_for | 予約対象のユーザーの sys_id またはメールアドレス。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 |
| 予約可能 | 予約に関連付けられた予約可能に関する詳細のリスト。 データタイプ：オブジェクトのアレイ "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| reservables.is_private | 予約がプライベートかどうかを示すフラグ。プライベートである場合、予約は所有者以外の誰にも表示されません。 これらのプライバシー設定について詳しくは、 [場所のプライバシー設定と影響](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)をご覧ください。 有効な値： * true:予約はプライベートです。 * false:予約はプライベートではありません。 データタイプ：ブーリアン デフォルト:システムプロパティでプライバシーに設定される値。 |
| reservables.sys_id | 予約を行う場所のSys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| reservable_module | 必須です。予約に関連付ける予約可能モジュールの sys_id。[予約可能モジュール](https://www.servicenow.com/docs/access?context=config-reservable-module&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)は、予約に必要な職場アイテムを定義します。予約可能なモジュール \[sn_wsd_rsv_reservable_module\] テーブルにあります。 データタイプ：文字列 |
| shift | 予約に関連付けるシフトの sys_id。シフト \[sn_wsd_core_shift\] テーブルにあります。このパラメーターが渡される場合、 end パラメーターは必要ありません。 シフトベースの予約の詳細については、「 [シフトベースの予約を有効にする](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
| start | 必須です。予約の要求された開始時間。 データタイプ：文字列 形式：UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| subject | 予約に関連付けられた会議の件名。 データタイプ：文字列 |
[表 : 9. 要求本文パラメーター]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-PATCH-update__entry__32}{#wsd_multi_reserv-PATCH-update__accept-reserv-entry}{#wsd_multi_reserv-PATCH-update__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 要求本文のデータ形式。サポートされるタイプ：application/json、application/xml、または text/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 10. 要求ヘッダー]

{#wsd_multi_reserv-PATCH-update__entry__38}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-PATCH-update__entry__42}{#wsd_multi_reserv-PATCH-update__entry-200-status-code}{#wsd_multi_reserv-PATCH-update__entry-401-status-code}{#wsd_multi_reserv-PATCH-update__entry-404-status-code}{#wsd_multi_reserv-PATCH-update__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター

{#wsd_multi_reserv-PATCH-update__entry__52}{#wsd_multi_reserv-PATCH-update__result-multi-entry}{#wsd_multi_reserv-PATCH-update__parent-multi-entry}{#wsd_multi_reserv-PATCH-update__success-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_error-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_reservable-multi-entry}{#wsd_multi_reserv-PATCH-update__successfulReservations_sys_id-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_error-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_reservable-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_success-multi-entry}{#wsd_multi_reserv-PATCH-update__unSuccessfulReservations_sy_id-multi-entry}

| 名前 | 説明 |
|-|-|
| result | 複数予約の作成または更新の結果を返します。 データタイプ：オブジェクト "result": { "parent": "String", "success": Boolean, "successfulReservations": Array, "unSuccessfulReservations": Array } |
| result.parent | 親予約の sys_id。親には、1 つ以上の子予約を関連付けることができます。 データタイプ：文字列 |
| result.success | 予約が正常に作成されたかどうかを示すフラグ。 可能な値： * true：正常に作成されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations | 正常に作成された予約のリスト。 データタイプ：アレイ "successfulReservations": [ { "cancelled": Boolean, "error": "String", "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| result.successfulReservations.cancelled | 予約が正常にキャンセルされたかどうかを示すフラグ。 可能な値： * true：正常にキャンセルされました。 * false：キャンセルされませんでした。 データタイプ：ブーリアン |
| result.successfulReservations.error | 予約の作成中に問題が発生した場合のエラーメッセージ。 データタイプ：文字列 |
| result.SuccessfulReservations.insert | 予約が正常に挿入されたかどうかを示すフラグ。予約が追加されたときなど。 可能な値： * true：正常に挿入されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations.reservable | 予約が行われた職場の sys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| result.successfulReservations.success | 関連する操作が成功したかどうかを示すフラグ。 可能な値： * true：操作に成功しました。 * false：操作に失敗しました。 データタイプ：ブーリアン |
| result.successfulReservations.sys_id | 作成された予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 データタイプ：文字列 |
| result.successfulReservations.update | 予約が正常に更新されたかどうかを示すフラグ。 可能な値： * true：正常に更新されました。 * false：更新されませんでした。 データタイプ：ブーリアン |
| result.unSuccessfulReservations | 正常に作成されなかった予約のリスト。 データタイプ：アレイ "unSuccessfulReservations": [ { "cancelled": Boolean, "error": "String", "insert": Boolean "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| result.unSuccessfulReservations.cancelled | 予約が正常にキャンセルされたかどうかを示すフラグ。 可能な値： * true：正常にキャンセルされました。 * false：キャンセルされませんでした。 データタイプ：ブーリアン |
| result.unSuccessfulReservations.error | 予約の作成中に問題が発生した場合のエラーメッセージ。 データタイプ：文字列 |
| result.unSuccessfulReservations.insert | 予約が正常に挿入されたかどうかを示すフラグ。 可能な値： * true：正常に挿入されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.unSuccessfulReservations.reservable | 予約が試行された職場の sys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| result.unSuccessfulReservations.success | 予約が正常に作成されたかどうかを示すフラグ。 可能な値： * true：正常に作成されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.unSuccessfulReservations.sys_id | 失敗した予約の sys_id。 常に null です。 データタイプ：文字列 |
| result.unSuccessfulReservations.update | 予約が正常に更新されたかどうかを示すフラグ。 可能な値： * true：正常に更新されました。 * false：更新されませんでした。 データタイプ：ブーリアン |
[ ]

### cURL 要求

次のコード例は、既存の複数予約のコンテンツを変更する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservables\":[
            { 
                \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\" 
            }, 
            {
                \"sys_id\":\"02000d4edb7650106c731dcd13961914\"
            }
        ],
        \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
        \"subject\":\"Test 1\",
        \"start\":\"2022-05-27 13:00:00\",
        \"end\":\"2022-05-27 14:00:00\",
        \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

返される結果：

    {
      "result": {
        "parent": "98ccb4348723cd106342b846dabb359a",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          }
        ],
        "unSuccessfulReservations": []
      }
    }

### cURL 要求

次のコード例は、既存の複数予約に職場の場所を追加する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false 
           }, 
           {
               \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
               \"is_private\": false
           },
        {
               \"sys_id\":\"c4308d4edb7650106c731dcd1396194c\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

返される結果：

    {
      "result": {
        "parent": "98ccb4348723cd106342b846dabb359a",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "updated": true,
            "cancelled": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          },
          {
            "success": true,
            "inserted": true,
            "sys_id": "9e6d78748723cd106342b846dabb35a5",
            "error": null,
            "reservable": "c4308d4edb7650106c731dcd1396194c"
          }
        ],
        "unSuccessfulReservations": []
      }
    }

### cURL 要求

次のコード例は、単一予約を複数予約に変換する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false
           }, 
           {
               \"sys_id\":\"5eafb44edb7650106c731dcd13961943\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

返される結果：

    {
      "result": {
        "success": true,
        "parent": "98ccb4348723cd106342b846dabb359a",
        "successfulReservations": [
          {
            "success": true,
            "inserted": true,
            "sys_id": "6cccb4348723cd106342b846dabb359d",
            "error": null,
            "reservable": "5eafb44edb7650106c731dcd13961943"
          },
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null
      }
    }

### cURL 要求

次のコード例は、複数予約を単一予約に変換する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/update/02000d4edb7650106c731dcd13961914" \
    --request PATCH \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
       \"reservables\":[
           { 
               \"sys_id\":\"fe1f744edb7650106c731dcd139619ca\",
               \"is_private\": false
           }
       ],
       \"reservable_module\":\"c31241cedb7650106c731dcd13961917\",
       \"subject\":\"Test 1\",
       \"start\":\"2022-05-27 13:00:00\",
       \"end\":\"2022-05-27 14:00:00\",
       \"requested_for\": \"workplace_user@example.com\"
    }" \
    --user 'username':'password'

返される結果：

    {
      "result": {
        "sys_id": "74af283c87ef8d106342b846dabb3592",
        "success": true,
        "successfulReservations": [
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": false,
            "sys_id": "74af283c87ef8d106342b846dabb3592",
            "reservable": "fe1f744edb7650106c731dcd139619ca",
            "error": ""
          },
          {
            "success": true,
            "insert": false,
            "update": true,
            "cancel": true,
            "sys_id": "3caf283c87ef8d106342b846dabb3596",
            "reservable": "5eafb44edb7650106c731dcd13961943"
          }
        ],
        "unSuccessfulReservations": [],
        "error": null
      }
    }

## WSD Multi Reservation - POST /api/sn_wsd_rsv/multi_reservation/add {#ariaid-title4}

異なる職場の場所で同じ時間に職場予約を作成します。
<br />

### URL 形式

バージョニングされている URL：/api/sn_wsd_rsv/{api_version}/multi_reservation/add

デフォルトの URL：/api/sn_wsd_rsv/multi_reservation/add

### サポートされている要求パラメーター

{#wsd_multi_reserv-POST-add__entry__2}{#wsd_multi_reserv-POST-add__version-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 13. パスパラメーター]

{#wsd_multi_reserv-POST-add__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 14. クエリパラメーター]

{#wsd_multi_reserv-POST-add__entry__10}{#wsd_multi_reserv-POST-add__end-update_reserv-entry}{#wsd_multi_reserv-POST-add__requested_for-update_reserv-entry}{#wsd_multi_reserv-POST-add__reservable_module-update_reserv-entry}{#wsd_multi_reserv-POST-add__shift-update_reserv-entry}{#wsd_multi_reserv-POST-add__start-update_reserv-entry}{#wsd_multi_reserv-POST-add__subject-update_reserv-entry}

| 名前 | 説明 |
|-|-|
| 終了 | shiftパラメーターが渡されない場合は必須です。予約の要求された終了時間。 データタイプ：文字列 形式：UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| requested_for | 予約対象のユーザーの sys_id またはメールアドレス。ユーザー \[sys_user\] テーブルにあります。 データタイプ：文字列 |
| 予約可能 | 予約に関連付けられた予約可能に関する詳細のリスト。 データタイプ：オブジェクトのアレイ "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| reservables.is_private | 予約がプライベートかどうかを示すフラグ。プライベートである場合、予約は所有者以外の誰にも表示されません。 これらのプライバシー設定について詳しくは、 [場所のプライバシー設定と影響](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)をご覧ください。 有効な値： * true:予約はプライベートです。 * false:予約はプライベートではありません。 データタイプ：ブーリアン デフォルト:システムプロパティでプライバシーに設定される値。 |
| reservables.sys_id | 予約を行う場所のSys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| reservable_module | 必須です。予約に関連付ける予約可能モジュールの sys_id。[予約可能モジュール](https://www.servicenow.com/docs/access?context=config-reservable-module&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)は、予約に必要な職場アイテムを定義します。予約可能なモジュール \[sn_wsd_rsv_reservable_module\] テーブルにあります。 データタイプ：文字列 |
| shift | 予約に関連付けるシフトの sys_id。シフト \[sn_wsd_core_shift\] テーブルにあります。このパラメーターが渡される場合、 end パラメーターは必要ありません。 シフトベースの予約の詳細については、「 [シフトベースの予約を有効にする](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
| start | 必須です。予約の要求された開始時間。 データタイプ：文字列 形式：UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| subject | 必須です。 予約に関連付けられた会議の件名。 データタイプ：文字列 |
[表 : 15. 要求本文パラメーター]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-POST-add__entry__30}{#wsd_multi_reserv-POST-add__accept-reserv-entry}{#wsd_multi_reserv-POST-add__content_type-JSON-only-entry-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 要求本文のデータ形式。サポートされるタイプ：application/json、application/xml、または text/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]

{#wsd_multi_reserv-POST-add__entry__36}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_multi_reserv-POST-add__entry__40}{#wsd_multi_reserv-POST-add__entry-200-status-code}{#wsd_multi_reserv-POST-add__entry-401-status-code}{#wsd_multi_reserv-POST-add__entry-404-status-code}{#wsd_multi_reserv-POST-add__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 18. ステータスコード]

### 応答本文のパラメーター

{#wsd_multi_reserv-POST-add__entry__50}{#wsd_multi_reserv-POST-add__result-multi-entry}{#wsd_multi_reserv-POST-add__parent-multi-entry}{#wsd_multi_reserv-POST-add__success-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_error-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_inserted-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_reservable-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_success-multi-entry}{#wsd_multi_reserv-POST-add__successfulReservations_sys_id-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_error-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_inserted-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_reservable-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_success-multi-entry}{#wsd_multi_reserv-POST-add__unSuccessfulReservations_sy_id-multi-entry}

| 名前 | 説明 |
|-|-|
| result | 複数予約の作成または更新の結果を返します。 データタイプ：オブジェクト "result": { "parent": "String", "success": Boolean, "successfulReservations": Array, "unSuccessfulReservations": Array } |
| result.parent | 親予約の sys_id。親には、1 つ以上の子予約を関連付けることができます。 データタイプ：文字列 |
| result.success | 予約が正常に作成されたかどうかを示すフラグ。 可能な値： * true：正常に作成されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations | 正常に作成された予約のリスト。 データタイプ：アレイ "successfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| result.successfulReservations.error | 予約の作成中に問題が発生した場合のエラーメッセージ。 データタイプ：文字列 |
| result.successfulReservations.inserted | 予約が正常に挿入されたかどうかを示すフラグ。予約が追加されたときなど。 可能な値： * true：正常に挿入されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations.reservable | 予約が行われた職場の sys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| result.successfulReservations.success | 予約が正常に作成されたかどうかを示すフラグ。 可能な値： * true：正常に作成されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.successfulReservations.sys_id | 作成された予約の sys_id。職場予約 \[sn_wsd_rsv_reservation\] テーブルにあります。 データタイプ：文字列 |
| result.unSuccessfulReservations | 正常に作成されなかった予約のリスト。 データタイプ：アレイ "unSuccessfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| result.unSuccessfulReservations.error | 予約の作成中に問題が発生した場合のエラーメッセージ。 データタイプ：文字列 |
| result.unSuccessfulReservations.inserted | 予約が正常に挿入されたかどうかを示すフラグ。 可能な値： * true：正常に挿入されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.unSuccessfulReservations.reservable | 予約が試行された職場の sys_id。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：文字列 |
| result.unSuccessfulReservations.success | 予約が正常に作成されたかどうかを示すフラグ。 可能な値： * true：正常に作成されました。 * false：操作に失敗しました。 データタイプ：ブール |
| result.unSuccessfulReservations.sys_id | 失敗した予約の sys_id。 常に null です。 データタイプ：文字列 |
[ ]

### cURL 要求

このコード例は、同じ予約に対して 2 つの異なる職場を予約する方法を示しています。

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/multi_reservation/add" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
        \"subject\": \"Test-123\",
        \"reservation_purpose\": \"meeting\",
        \"timezone\": \"US/Pacific\",
        \"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
        \"reservables\": [
            {
                \"sys_id\": \"fe1f744edb7650106c731dcd139619ca\",
                \"is_private\": false
            },
            {
                \"sys_id\": \"d1208d4edb7650106c731dcd1396194a\",
                \"is_private\": false
            }
        ],
        \"start\": \"2023-01-12T11:30:00Z\",
        \"end\": \"2023-01-12T12:30:00Z\",
        \"reservation_type\": \"space\"
    }" \
    --user "username":"password"

返される結果：

    {
      "result": {
        "success": true,
        "parent": "08e8a18687586550cfaa99b73cbb354f",
        "successfulReservations": [
          {
            "success": true,
            "inserted": true,
            "sys_id": "44e8a18687586550cfaa99b73cbb3552",
            "error": null,
            "reservable": "fe1f744edb7650106c731dcd139619ca"
          },
          {
            "success": true,
            "inserted": true,
            "sys_id": "04e8a18687586550cfaa99b73cbb3555",
            "error": null,
            "reservable": "d1208d4edb7650106c731dcd1396194a"
          }
        ],
        "unSuccessfulReservations": []
      }
    }