---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD 複数予約 API

# WSD 複数予約 API {#ariaid-title1}

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

ワークプレイスサービスデリバリ (WSD) 複数予約 API は、複数の職場の場所の予約を管理するためのエンドポイントを提供します。
この API にアクセスするには、発信者に sn_wsd_core.workplace_user ロールが必要であり、ワークプレイス安全管理 (sn_wsd_core) プラグインとワークプレイス予約管理 (sn_wsd_rsv) プラグインがアクティブ化されている必要があります。

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

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

## WSD 複数予約: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}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

{#wsd_multi_reserv-PATCH-cancel__entry__2}{#wsd_multi_reserv-PATCH-cancel__version-not_optional-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/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 複数予約: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}  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

{#wsd_multi_reserv-PATCH-update__entry__2}{#wsd_multi_reserv-PATCH-update__version-not_optional-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=australia&pubname=australia-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=australia&pubname=australia-employee-service-management&ft:locale=en-US)は、予約に必要な職場アイテムを定義します。 データタイプ：文字列 テーブル:予約可能なモジュール \[sn_wsd_rsv_reservable_module\] |
| シフト | 予約に関連付けるシフトのSys_id。このパラメーターが渡される場合、 end パラメーターは必須ではありません。 シフトベースの予約の詳細については、「 [シフトベースの予約を有効にする」](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)を参照してください。 データタイプ：文字列 テーブル:シフト \[sn_wsd_core_shift\] |
| 開始 | 必須です。予約の要求された開始時間。 データタイプ：文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| 件名 | 予約に関連付けられた会議の件名。 データタイプ：文字列 |
[表 : 9. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 | 予約の作成中に問題が発生した場合のエラーメッセージ。 データタイプ：文字列 |
| 結果。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 複数予約: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  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

{#wsd_multi_reserv-POST-add__entry__2}{#wsd_multi_reserv-POST-add__version-not_optional-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=australia&pubname=australia-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=australia&pubname=australia-employee-service-management&ft:locale=en-US)は、予約に必要な職場アイテムを定義します。 データタイプ：文字列 テーブル:予約可能なモジュール \[sn_wsd_rsv_reservable_module\] |
| シフト | 予約に関連付けるシフトのSys_id。このパラメーターが渡される場合、 end パラメーターは必須ではありません。 シフトベースの予約の詳細については、「 [シフトベースの予約を有効にする」](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)を参照してください。 データタイプ：文字列 テーブル:シフト \[sn_wsd_core_shift\] |
| 開始 | 必須です。予約の要求された開始時間。 データタイプ：文字列 形式:UTC または現地時間 (yyyy-mm-dd hh:mm:ss) |
| 件名 | 必須です。 予約に関連付けられた会議の件名。 データタイプ：文字列 |
[表 : 15. 要求本文のパラメーター]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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": []
      }
    }