---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD-Mehrfachreservierungs-API

# WSD-Mehrfachreservierungs-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 13 Minuten Lesedauer

Die Workplace Service Delivery(WSD) Mehrfachreservierung Die API stellt Endpunkte für die Verwaltung von Reservierungen mit mehreren Arbeitsplatzstandorten bereit.
Um auf diese API zuzugreifen, muss der Anrufer über die Rolle „sn_wsd_core.workplace_user" verfügen, und die Plugins „Arbeitsplatzsicherheitsmanagement" (sn_wsd_Core) und „Arbeitsplatzreservierungsmanagement" (sn_wsd_rsv) müssen aktiviert sein.

Diese API wird in ausgeführt `sn_wsd_rsv `Namespace.

Für zusätzliche Informationen zu Management von Arbeitsplatz-Reservierungen, Siehe [Verwaltung Von Arbeitsplatzreservierungen](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US).

## WSD-Mehrfachreservierung -- PATCH /api/sn_wsd_rsv/Multi_reservation/Cancel/{sys_ID} {#ariaid-title2}

Bricht eine angegebene Mehrfachreservierung ab.
<br />

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/Multi_reservation/Cancel/{sys_ID}

Standard-URL: /api/sn_wsd_rsv/Multi_reservation/Cancel/{sys_ID}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | SYS_ID der Mehrfachreservierung, die abgebrochen werden soll. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
[Tabelle : 1. Pfad-Parameter]

{#wsd_multi_reserv-PATCH-cancel__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#wsd_multi_reserv-PATCH-cancel__entry__12}

| Name | Beschreibung |
|-|-|
| Cancel_Notes | Grund für die Stornierung der Reservierung. Datentyp: Zeichenfolge |
[Tabelle : 3. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xmlOder, text/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#wsd_multi_reserv-PATCH-cancel__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter

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

| Name | Beschreibung |
|-|-|
| Ergebnis | Details der Ergebnisse der Abbruchanforderung. Datentyp: Objekt "result": { "error": "String", "parent": "String", "success": Boolean, "successfulReservations": [Array], "unSuccessfulReservations": [Array] } |
| Ergebnis.Fehler | Nachricht, die den zugehörigen Fehler beschreibt. Datentyp: Zeichenfolge |
| Ergebnis.übergeordnetes Element | SYS_ID der übergeordneten Reservierung. Einem übergeordneten Element ist möglicherweise eine oder mehrere untergeordnete Reservierungen zugeordnet. Datentyp: Zeichenfolge |
| Ergebnis.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde. Mögliche Werte: * Wahr: Erfolgreich abgebrochen. * Falsch: Reservierung wurde nicht storniert. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen | Details zur erfolgreichen Stornierung der Mehrfachreservierung. Datentyp: Array von Objekten "successfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.successfulReservations.msg | Abbruchnachricht. Datentyp: Zeichenfolge |
| Ergebnis.Erfolgsreservierungen.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde. Mögliche Werte: * Wahr: Erfolgreich abgebrochen. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen.sys_ID | SYS_ID der stornierten Reservierung. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Ergebnis.nicht erfolgreiche Reservierungen | Details zur nicht erfolgreichen Stornierung der Mehrfachreservierung. Datentyp: Array von Objekten "unSuccessfulReservations": [ { "msg": "String", "success": Boolean, "sys_id": "String" } ] |
| result.unSuccessfulReservations.msg | Abbruchnachricht. Datentyp: Zeichenfolge |
| Ergebnis.nicht erfolgreiche Reservierungen.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde. Mögliche Werte: * Wahr: Erfolgreich abgebrochen. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.unerfolgreiche Reservierungen.sys_ID | SYS_ID der Reservierung, die nicht storniert wurde. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie mehrere Reservierungen storniert werden.

    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'"

Ergebnisse zurückgeben:

    {
      "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-Mehrfachreservierung -- PATCH /api/sn_wsd_rsv/Multi_reservation/Update/{sys_ID} {#ariaid-title3}

Aktualisiert die Reservierungen, die einer Mehrfachreservierung zugeordnet sind, bei der dieselbe Reservierung (Besprechung) mehrere Arbeitsplatzstandorte hat.
Dieser Endpunkt kann vier verschiedene Update-Szenarien verarbeiten:

1. Aktualisieren Sie den Inhalt des Datensatzes mit mehreren Reservierungen, z. B. Betreff, Datum oder Uhrzeit.
2. Konvertieren Sie die Mehrfachreservierung basierend auf dem übergeordneten Element in eine einzelne Reservierung (Reservierung für einen einzelnen Arbeitsplatzstandort).
3. Konvertieren Sie eine einzelne Reservierung (Reservierung für einen einzelnen Arbeitsplatzstandort) in eine Mehrfachreservierung.
4. Fügen Sie einer vorhandenen Mehrfachreservierung einen Arbeitsplatzstandort hinzu oder entfernen Sie ihn.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/Multi_reservation/Update/{sys_ID}

Standard-URL: /api/sn_wsd_rsv/Multi_reservation/Update/{sys_ID}  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | SYS_ID der zu aktualisierenden Reservierung. * Einzelne Reservierung für Mehrfachreservierung: SYS_ID der einzelnen Reservierung.Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] * Aktualisieren Sie den Inhalt der Mehrfachreservierung: SYS_ID des übergeordneten Reservierungsdatensatzes.Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] Informationen zum Abrufen der Details einer mehrfach übergeordneten Reservierung aus dem untergeordneten Datensatz finden Sie unter sys_ID im Feld „Source_reservation" des untergeordneten Datensatzes. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#wsd_multi_reserv-PATCH-update__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#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}

| Name | Beschreibung |
|-|-|
| end | Erforderlich, wenn shiftParameter wird nicht übergeben. Angeforderte Endzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| requested_for | SYS_ID oder E-Mail-Adresse des Anwenders, für den die Reservierung vorgenommen wird. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| reservierbare Elemente | Liste der Details zu den reservierbaren Elementen, die der Reservierung zugeordnet sind. Datentyp: Array von Objekten "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| Reservierbar.is_privat | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung niemandem außer dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter [Datenschutzeinstellungen und Auswirkung des Standorts](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Gültige Werte: * Wahr: Reservierung ist privat. * Falsch: Reservierung ist nicht privat. Datentyp: Boolescher Wert Standard: Wert für Datenschutz in den Systemeigenschaften festgelegt. |
| Reservierbare.sys_ID | SYS_ID des Standorts, an dem die Reservierungen vorgenommen werden sollen. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Reservierbar_Modul | Erforderlich. SYS_ID des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. A [Reservierbares Modul](https://www.servicenow.com/docs/access?context=config-reservable-module&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US)Definiert die Arbeitsplatzelemente, die für eine Reservierung erforderlich sind. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| Umschalt | SYS_ID der Schicht, die der Reservierung zugeordnet werden soll. Wenn dieser Parameter übergeben wird, wird endParameter ist nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter [Schichtbasierte Reservierung aktivieren](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle: Schicht \[sn_wsd_core_shift\] |
| start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| subject | Betreff der Besprechung, die der Reservierung zugeordnet ist. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xmlOder, text/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#wsd_multi_reserv-PATCH-update__entry__38}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter

{#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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Gibt Ergebnisse aus der Erstellung oder Aktualisierung mehrerer Reservierungen zurück. Datentyp: Objekt "result": { "parent": "String", "success": Boolean, "successfulReservations": [Array], "unSuccessfulReservations": [Array] } |
| Ergebnis.übergeordnetes Element | SYS_ID der übergeordneten Reservierung. Einem übergeordneten Element ist möglicherweise eine oder mehrere untergeordnete Reservierungen zugeordnet. Datentyp: Zeichenfolge |
| Ergebnis.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde. Mögliche Werte: * Wahr: Erfolgreich erstellt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen | Liste der Reservierungen, die erfolgreich erstellt wurden. Datentyp: Array von Objekten "successfulReservations": [ { "cancelled": Boolean, "error": "String", "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| result.successfulReservations.cancelled | Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde. Mögliche Werte: * Wahr: Erfolgreich abgebrochen. * Falsch: Nicht abgebrochen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen.Fehler | Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist. Datentyp: Zeichenfolge |
| result.SuccessfulReservations.insert | Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Z. B. wenn eine Reservierung hinzugefügt wird. Mögliche Werte: * Wahr: Erfolgreich eingefügt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.erfolgreiche Reservierungen.reservierbar | SYS_ID des Arbeitsplatzes, für den die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.Erfolgsreservierungen.Erfolg | Kennzeichnung, die angibt, ob der zugeordnete Vorgang erfolgreich war. Mögliche Werte: * Wahr: Vorgang war erfolgreich. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen.sys_ID | SYS_ID der erstellten Reservierung. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Ergebnis.Erfolgsreservierungen.Update | Kennzeichnung, die angibt, ob die Reservierung erfolgreich aktualisiert wurde. Mögliche Werte: * Wahr: Erfolgreich aktualisiert. * Falsch: Nicht aktualisiert. Datentyp: Boolescher Wert |
| Ergebnis.nicht erfolgreiche Reservierungen | Liste der nicht erfolgreichen Reservierungen. Datentyp: Array von Objekten "unSuccessfulReservations": [ { "cancelled": Boolean, "error": "String", "insert": Boolean "reservable": "String" "success": Boolean, "sys_id": "String", "updated": Boolean } ] |
| result.unSuccessfulReservations.cancelled | Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde. Mögliche Werte: * Wahr: Erfolgreich abgebrochen. * Falsch: Nicht abgebrochen. Datentyp: Boolescher Wert |
| Ergebnis.unerfolgreiche Reservierungen.Fehler | Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist. Datentyp: Zeichenfolge |
| result.unSuccessfulReservations.insert | Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Mögliche Werte: * Wahr: Erfolgreich eingefügt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.nicht erfolgreiche Reservierungen.reservierbar | SYS_ID des Arbeitsplatzes, für den die Reservierung vorgenommen werden wollte. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.nicht erfolgreiche Reservierungen.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde. Mögliche Werte: * Wahr: Erfolgreich erstellt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.unerfolgreiche Reservierungen.sys_ID | SYS_ID der nicht erfolgreichen Reservierung. Immer null. Datentyp: Zeichenfolge |
| Ergebnis.nicht erfolgreiche Reservierungen.Update | Kennzeichnung, die angibt, ob die Reservierung erfolgreich aktualisiert wurde. Mögliche Werte: * Wahr: Erfolgreich aktualisiert. * Falsch: Nicht aktualisiert. Datentyp: Boolescher Wert |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie der Inhalt einer vorhandenen Mehrfachreservierung geändert wird.

    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'

Ergebnisse zurückgeben:

    {
      "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-Anforderung

Das folgende Codebeispiel zeigt, wie ein Arbeitsplatzstandort zu einer vorhandenen Mehrfachreservierung hinzugefügt wird.

    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'

Ergebnisse zurückgeben:

    {
      "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-Anforderung

Das folgende Codebeispiel zeigt, wie eine einzelne Reservierung in eine Mehrfachreservierung konvertiert wird.

    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'

Ergebnisse zurückgeben:

    {
      "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-Anforderung

Das folgende Codebeispiel zeigt, wie eine Mehrfachreservierung in eine einzelne Reservierung konvertiert wird.

    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'

Ergebnisse zurückgeben:

    {
      "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-Mehrfachreservierung -- POSTEN /api/sn_wsd_rsv/Multi_reservation/add {#ariaid-title4}

Erstellt Arbeitsplatzreservierungen für die gleiche Zeit an verschiedenen Arbeitsplatzstandorten.
<br />

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/Multi_reservation/add

Standard-URL: /api/sn_wsd_rsv/Multi_reservation/add  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#wsd_multi_reserv-POST-add__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#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}

| Name | Beschreibung |
|-|-|
| end | Erforderlich, wenn shiftParameter wird nicht übergeben. Angeforderte Endzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| requested_for | SYS_ID oder E-Mail-Adresse des Anwenders, für den die Reservierung vorgenommen wird. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| reservierbare Elemente | Liste der Details zu den reservierbaren Elementen, die der Reservierung zugeordnet sind. Datentyp: Array von Objekten "reservables": [ { "is_private": Boolean, "sys_id": "String" } ] |
| Reservierbar.is_privat | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung niemandem außer dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter [Datenschutzeinstellungen und Auswirkung des Standorts](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Gültige Werte: * Wahr: Reservierung ist privat. * Falsch: Reservierung ist nicht privat. Datentyp: Boolescher Wert Standard: Wert für Datenschutz in den Systemeigenschaften festgelegt. |
| Reservierbare.sys_ID | SYS_ID des Standorts, an dem die Reservierungen vorgenommen werden sollen. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Reservierbar_Modul | Erforderlich. SYS_ID des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. A [Reservierbares Modul](https://www.servicenow.com/docs/access?context=config-reservable-module&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US)Definiert die Arbeitsplatzelemente, die für eine Reservierung erforderlich sind. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| Umschalt | SYS_ID der Schicht, die der Reservierung zugeordnet werden soll. Wenn dieser Parameter übergeben wird, wird endParameter ist nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter [Schichtbasierte Reservierung aktivieren](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle: Schicht \[sn_wsd_core_shift\] |
| start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| subject | Erforderlich. Betreff der Besprechung, die der Reservierung zugeordnet ist. Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstext-Parameter]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xmlOder, text/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#wsd_multi_reserv-POST-add__entry__36}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter

{#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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Gibt Ergebnisse aus der Erstellung oder Aktualisierung mehrerer Reservierungen zurück. Datentyp: Objekt "result": { "parent": "String", "success": Boolean, "successfulReservations": [Array], "unSuccessfulReservations": [Array] } |
| Ergebnis.übergeordnetes Element | SYS_ID der übergeordneten Reservierung. Einem übergeordneten Element ist möglicherweise eine oder mehrere untergeordnete Reservierungen zugeordnet. Datentyp: Zeichenfolge |
| Ergebnis.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde. Mögliche Werte: * Wahr: Erfolgreich erstellt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen | Liste der Reservierungen, die erfolgreich erstellt wurden. Datentyp: Array von Objekten "successfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| Ergebnis.Erfolgsreservierungen.Fehler | Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist. Datentyp: Zeichenfolge |
| result.successfulReservations.inserted | Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Z. B. wenn eine Reservierung hinzugefügt wird. Mögliche Werte: * Wahr: Erfolgreich eingefügt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.erfolgreiche Reservierungen.reservierbar | SYS_ID des Arbeitsplatzes, für den die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.Erfolgsreservierungen.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde. Mögliche Werte: * Wahr: Erfolgreich erstellt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.Erfolgsreservierungen.sys_ID | SYS_ID der erstellten Reservierung. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Ergebnis.nicht erfolgreiche Reservierungen | Liste der Reservierungen, die nicht erfolgreich waren. Datentyp: Array von Objekten "unSuccessfulReservations": [ { "error": "String", "inserted": Boolean, "reservable": "String" "success": Boolean, "sys_id": "String" } ] |
| Ergebnis.unerfolgreiche Reservierungen.Fehler | Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist. Datentyp: Zeichenfolge |
| result.unSuccessfulReservations.inserted | Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Mögliche Werte: * Wahr: Erfolgreich eingefügt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.nicht erfolgreiche Reservierungen.reservierbar | SYS_ID des Arbeitsplatzes, für den die Reservierung vorgenommen werden wollte. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.nicht erfolgreiche Reservierungen.Erfolg | Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde. Mögliche Werte: * Wahr: Erfolgreich erstellt. * Falsch: Vorgang fehlgeschlagen. Datentyp: Boolescher Wert |
| Ergebnis.unerfolgreiche Reservierungen.sys_ID | SYS_ID der nicht erfolgreichen Reservierung. Immer null. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Codebeispiel zeigt, wie zwei verschiedene Arbeitsplätze für dieselbe Reservierung reserviert werden.

    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"

Ergebnisse zurückgeben:

    {
      "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": []
      }
    }


