---
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-Such-API

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

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

Die Workplace Service Delivery(WSD) Suchen Die API stellt Endpunkte zur Suche nach verfügbaren Standorten und Arbeitsplatzelementen bereit, z. B. reservierbare Elemente, reservierbare Module und verfügbare Schichten.
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-Suche: RUFT /api/sn_wsd_rsv/search/Availability AB {#ariaid-title2}

Überprüft, ob die angegebenen reservierbaren Elemente für die angegebenen Zeiten verfügbar sind.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/Availability

Standard-URL: /api/sn_wsd_rsv/search/Availability  
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_search-GET-availability__entry__2}{#wsd_search-GET-availability__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 : 1. Pfad-Parameter]

{#wsd_search-GET-availability__entry__6}{#wsd_search-GET-availability__end-query-reserv-entry}{#wsd_search-GET-availability__include_reservations_within_days-reserv-entry}{#wsd_search-GET-availability__reservation_ids-reserv-entry}{#wsd_search-GET-availability__reservable_module-reserv-entry}{#wsd_search-GET-availability__schedule_view_obj-reserv-entry}{#wsd_search-GET-availability__schedule_view_obj-schedule_view_date-reserv-entry}{#wsd_search-GET-availability__schedule_view_obj-timezone-entry}{#wsd_search-GET-availability__start-query-reserv-entry}

| Name | Beschreibung |
|-|-|
| end | Erforderlich. Endzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss nach dem in angegebenen Wert liegen startParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| include_reservations_within_days | Kennzeichnung, die angibt, ob alle freien Zeitfenster mit verfügbaren Zeiten in der Antwort für jedes reservierbare Element für den ganzen Tag zurückgegeben werden sollen. Gültige Werte: * Wahr: Gibt alle freien Slots zurück. * Falsch: Nicht alle freien Slots zurückgeben. Datentyp: Boolescher Wert Standard: Falsch |
| Reservierbare_IDs | Erforderlich. Kommagetrennte Liste reservierbarer sys_IDs, die auf die Verfügbarkeit ausgewertet werden sollen. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Reservation_IDs | Kommagetrennte Liste der vorhandenen Reservierungs-sys_IDs. Übergeben Sie diesen Parameter, wenn Sie die zugehörigen Reservierungen bearbeiten möchten. Die Zeit, die für diese sys_IDs für die entsprechenden reservierbaren Elemente gesperrt ist, wird als verfügbar behandelt. Datentyp: Zeichenfolge Standard: Keine Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Reservierbar_Modul | Erforderlich. SYS_ID des reservierbaren Moduls, das in die Suche aufgenommen 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)Gruppiert ähnliche Typen von Arbeitsplatzelementen. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| Schedule_View_obj | Details zur zurückzugebenden Zeitplanansicht. Übergeben Sie dieses Objekt, wenn Sie 24-Stunden-Verfügbarkeitsdaten für Reservierungen benötigen, die mehr als einen Tag umfassen. Die Rückgabeergebnisse enthalten nur verfügbare Zeiten und Reservierungen für das angegebene Datum. Damit diese Funktionalität ordnungsgemäß funktioniert, die Parameter ignore_same_day_validationUnd include_reservations_within_daysMuss auf festgelegt werden <kbd class="ph userinput">Wahr </kbd>. Datentyp: Objekt "schedule_view_obj": { "schedule_view_date": "String", "timezone": "String" } |
| schedule_view_obj.schedule_view_date | Datum, für das mit der Rückgabe der Reservierungsverfügbarkeit begonnen werden soll. Dieses Datum muss sich in der in angegebenen Zeitzone befinden schedule_view_obj.timezoneParameter. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT |
| Schedule_View_obj.timezone | Zeitzone wird erstellt, die zum Bestimmen der zurückzugebenden Reservierungsverfügbarkeitsdaten verwendet werden soll. Beispiel: USA/Pazifik. Datentyp: Zeichenfolge |
| Umschalt | Erforderlich, wenn die angegebenen reservierbaren Module auf einer Schicht basieren. 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. Startzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss vor dem in angegebenen Wert liegen endParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
[Tabelle : 2. Abfrageparameter]

{#wsd_search-GET-availability__entry__28}

| Name | Beschreibung |
|-|-|
| Keine |   |
[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_search-GET-availability__entry__32}{#wsd_search-GET-availability__accept-reserv-entry}

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

{#wsd_search-GET-availability__entry__36}

| 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_search-GET-availability__entry__40}{#wsd_search-GET-availability__entry-200-status-code}{#wsd_search-GET-availability__entry-401-status-code}{#wsd_search-GET-availability__entry-404-status-code}{#wsd_search-GET-availability__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_search-GET-availability__entry__50}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste aller verfügbaren wiederverwendbaren Elemente für die angegebenen Zeiten. Datentyp: Array von Objekten "result": [ { "availableTimes": [Array], "building": {Object}, "campus": {Object}, "email": "String", "floor": {Object}, "is_available": Boolean, "name": "String", "reservations": [Array], "sys_id": "String" } ] |
| Ergebnis.VerfügbarZeiten | Liste der Daten/Uhrzeiten, zu denen das zugehörige reservierbare Element verfügbar ist. Datentyp: Array |
| Ergebnis.Gebäude | Details zum Gebäude, das dem reservierbaren Element zugeordnet ist. Datentyp: Objekt "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.Gebäude.Anzeigewert | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| result.building.name | Name des Gebäudes. Datentyp: Zeichenfolge |
| Ergebnis.Gebäude.sys_ID | SYS_ID des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.campus | Details zum Campus, der dem reservierbaren Element zugeordnet ist. Datentyp: Objekt "campus": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.campus.display_value | Anzeigenummer des Campus, auf dem sich das reservierbare Element befindet, z. B. East Bay. Datentyp: Zeichenfolge |
| result.campus.name | Name des Campus. Datentyp: Zeichenfolge |
| result.campus.sys_id | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Campus \[sn_wsd_core_campus\] |
| Ergebnis.E-Mail | E-Mail-Adresse für das zugehörige reservierbare Element. Datentyp: Zeichenfolge |
| Ergebnis.Stockwerk | Details zum Stockwerk, das dem reservierbaren Element zugeordnet ist. Datentyp: Objekt "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.Stockwerk.Anzeigewert | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| result.floor.name | Name des Stockwerks, in dem sich das reservierbare Element befindet. Datentyp: Zeichenfolge |
| Ergebnis.Stockwerk.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Result.is_available | Kennzeichnung, die angibt, ob das reservierbare Element für die Reservierung verfügbar ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Nicht verfügbar für Reservierung. Datentyp: Boolescher Wert |
| result.name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen | Details zur zugehörigen Reservierung. Datentyp: Array von Objekten "reservations": [ { "configuration_item": "String", "end": "String", "is_collided": Boolean, "location": {Object}, "number": "String", "requested_for": {Object}, "reservation_purpose": {Object}, "start": "String", "state": {Object}, "subject": "String", "sys_id": "String" } ] |
| Ergebnis.Reservierungen.Configuration_item | Konfigurationselemente, die der Reservierung entsprechen. Datentyp: Zeichenfolge Tabelle: Konfigurationselement \[cmdb_ci\] |
| Ergebnis.Reservierungen.Ende | Enddatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC: jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.Reservierungen.is_Collided | Kennzeichnung, die angibt, ob die Reservierung mit der Start- und Endzeit der Suche kollidiert. Dies gibt an, dass der zugeordnete reservierbare Standort bereits für die angegebene Suchzeitspanne reserviert ist. Mögliche Werte: * Wahr: Kollision. * Falsch: Keine Kollision. Datentyp: Boolescher Wert |
| Ergebnis.Reservierungen.Standort | Details zum Standort der Reservierung. Datentyp: Objekt "location": { "location": "String", "timezone": {Object} } |
| Ergebnis.Reservierungen.Standort.Standort | SYS_ID des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.Reservierungen.Standort.Zeitzone | Details zur Zeitzone, die dem Standort zugeordnet ist. Datentyp: Objekt "timezone": { "displayValue": "String", "value": "String" } |
| Ergebnis.Reservierungen.Standort.Zeitzone.​Anzeigewert | Anzeigewert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.Standort.Zeitzone.Wert | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.Nummer | Reservierungsnummer. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.angefordert_für | Details zur Person, für die die Reservierung angefordert wurde. Datentyp: Objekt "requested_for": { "name": "String", "sys_id": "String" } |
| result.reservations.requested_for.name | Name des Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.angefordert_für.sys_ID | SYS_ID des Anwenders, für den die Reservierung angefordert wird. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Ergebnis.Reservierungen.reservation_purpose | Details zum Zweck der Reservierung. Datentyp: Objekt "reservation_purpose": { "display_value": "String", "value": "String" } |
| Ergebnis.Reservierungen.reservation_purpose.​Display_value | Anzeigewert für den Zweck der Reservierung, z. B. Unternehmensbesprechung. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.reservation_purpose.value | Interner Wert für den Zweck der Reservierung, z. B. Company_Meeting. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.Start | Startdatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC -- jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.Reservierungen.Status | Details zum Status der Reservierung für den Standort. Datentyp: Objekt "state": { "display_value": "String", "value": "String" } |
| Ergebnis.Reservierungen.Status.Display_value | Anzeigewert für den aktuellen Status der Reservierung, z. B. bestätigt. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.Status.Wert | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.Betreff | Betreff der Reservierung. Datentyp: Zeichenfolge |
| Ergebnis.Reservierungen.sys_ID | Erforderlich. SYS_ID des Reservierungsdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird. Hinweis: Zeilenumbrüche wurden den Abfrageparametern hinzugefügt, um das Lesen zu erleichtern.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability?
    reservable_module=5db44502dbb650106c731dcd13961937&
    start=2023-10-12T11:00:00Z&
    end=2023-10-15T12:00:00Z&
    reservable_ids=adb35f1977220110b3d7be377b5a99fc&
    reservation_ids=undefined&
    shift=undefined&
    schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
    timezone=Europe/Paris&
    include_reservations_within_days=true&
    ignore_same_day_validation=true&
    include_unavailable_items=true"  \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": [
        {
          "sys_id": "fe1f744edb7650106c731dcd139619ca",
          "email": null,
          "name": "Aspen",
          "is_available": true,
          "availableTimes": [
            [
              "2022-04-23 07:00:00",
              "2022-04-23 08:30:00"
            ],
            [
              "2022-04-23 09:30:00",
              "2022-04-23 23:00:00"
            ],
            [
              "2022-04-24 00:00:00",
              "2022-04-24 06:59:59"
            ]
          ],
          "floor": {
            "sys_id": "2f554296dbba10106c731dcd139619ed",
            "display_value": "Floor 2",
            "name": "Floor 2"
          },
          "building": {
            "sys_id": "94e264cedb3650106c731dcd13961919",
            "display_value": "CAL-B1",
            "name": "CAL-B1"
          },
          "campus": {
            "sys_id": "82b2a0cedb3650106c731dcd139619e9",
            "display_value": "California Campus",
            "name": "California Campus"
          },
          "reservations": [
            {
              "sys_id": "5fe65830874bc9106342b846dabb352b",
              "number": "WRES0001001",
              "location": {
                "location": "fe1f744edb7650106c731dcd139619ca",
                "timezone": {
                  "value": "US/Pacific",
                  "displayValue": "US/Pacific"
                }
              },
              "configuration_item": null,
              "start": "2022-04-23T08:30:00Z",
              "end": "2022-04-23T09:30:00Z",
              "subject": null,
              "reservation_purpose": {
                "value": "meeting",
                "display_value": "Meeting"
              },
              "state": {
                "value": "confirmed",
                "display_value": "Confirmed"
              },
              "is_collided": false,
              "requested_for": {
                "sys_id": "2de07e1887cb89106342b846dabb35fe",
                "name": "Workplace User"
              }
            }
          ]
        }
      ]
    }

## WSD-Suche: RUFT /api/sn_wsd_rsv/search/BEST_match AB {#ariaid-title3}

Sucht basierend auf den angegebenen Suchkriterien nach der besten Übereinstimmung mit reservierbaren Elementen.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/BEST_match

Standard-URL: /api/sn_wsd_rsv/search/BEST_match  
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_search-GET-best_match__entry__2}{#wsd_search-GET-best_match__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 : 7. Pfad-Parameter]

{#wsd_search-GET-best_match__entry__6}{#wsd_search-GET-best_match__end-query-reserv-entry}{#wsd_search-GET-best_match__include_reservable_purposes-reserv-entry}{#wsd_search-GET-best_match__include_reservations_within_days-reserv-entry}{#wsd_search-GET-best_match__include_standard_services-reserv-entry}{#wsd_search-GET-best_match__q-reserv-entry}{#wsd_search-GET-best_match__reservable_module-reserv-entry}{#wsd_search-GET-best_match__start-query-reserv-entry}{#wsd_search-GET-best_match__timezone_q_parm-reserv-query}

| Name | Beschreibung |
|-|-|
| BEST_match_count | Anzahl der am besten übereinstimmenden Reservierungen, die zurückgegeben werden sollen. Datentyp: Zahl Standard: 1 |
| end | Erforderlich. Endzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss nach dem in angegebenen Wert liegen startParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| Include_reservable_purposes | Kennzeichnung, die angibt, ob der Zweck der Reservierung des Arbeitsplatzstandorts für jedes reservierbare Element in den Rückgabeergebnissen zurückgegeben werden soll. Gültige Werte: * Wahr: Reservierbare Zwecke zurückgeben. * Falsch: Geben Sie die reservierbaren Zwecke nicht zurück. Datentyp: Boolescher Wert Standard: Falsch Tabelle: Reservierbarer Zweck \[sn_wsd_rsv_reservable_purpose\] |
| include_reservations_within_days | Kennzeichnung, die angibt, ob alle freien Zeitfenster mit verfügbaren Zeiten in der Antwort für jedes reservierbare Element für den ganzen Tag zurückgegeben werden sollen. Gültige Werte: * Wahr: Gibt alle freien Slots zurück. * Falsch: Nicht alle freien Slots zurückgeben. Datentyp: Boolescher Wert Standard: Falsch |
| Include_Standard_​-Services | Kennzeichnung, die angibt, ob die Standardserviceinformationen in der Antwort zurückgegeben werden sollen. Diese Informationen befinden sich in der Tabelle „Standardservice" \[sn_wsd_rsv_standard_service\]. Ein Standardservice beschreibt grundlegende Vorkehrungen, die bei der Reservierung mit einem reservierbaren Arbeitsplatzelement verfügbar sind, z. B. Whiteboards, zusätzliche Monitore und ähnliche Services. Weitere Informationen zu Standardservices finden Sie unter [Standardservices](https://www.servicenow.com/docs/access?context=standard-service&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Gültige Werte: * Wahr: Standardserviceinformationen zurückgeben. * Falsch: Geben Sie die Standardserviceinformationen nicht zurück. Datentyp: Boolescher Wert Standard: Falsch |
| q | Erforderlich. Codierte Abfrage, die zum Filtern der Suchergebnisse verwendet werden soll. In dieser Abfrage müssen Sie die sys_ID des Gebäudes angeben, und Sie können Parameter wie Stockwerk, Fläche, Kapazität, Standardservices und reservierbare Zwecke angeben. Alle übergebenen Parameter müssen sys_IDs sein, mit Ausnahme der Kapazität, die eine Zahl ist. Beispiel: `q=Building=94e264cedb3650106c731dcd13961919​^floorINfc7368cedb3650106c731dcd13961902​^Capacity>=1​^Standard_Services=55c0818edb7650106c731dcd13961904​^reservable_purposes=d6e5cd1ba4e01061904 ` Sie finden diese Informationen in den folgenden Tabellen: * Bereich: sn_wsd_core_area * Gebäude: sn_wsd_core_building * Stockwerk: sn_wsd_core_floor * Reservierbare Zwecke: sn_wsd_rsv_reservable_purpose * Standardservices: sn_wsd_rsv_standard_service Datentyp: Zeichenfolge |
| Reservierbar_Modul | Erforderlich. SYS_ID des reservierbaren Moduls, das in die Suche aufgenommen 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)Gruppiert ähnliche Typen von Arbeitsplatzelementen. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| start | Erforderlich. Startzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss vor dem in angegebenen Wert liegen endParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| Time_Slot | SYS_ID eines Zeitfenster-Datensatzes, für den wir nach dem am besten passenden reservierbaren Element suchen. Datentyp: Zeichenfolge Standard: Keine Tabelle: Zeitfenster \[sn_wsd_rsv_time_slot\] |
| Feld | Bevorzugte Zeitzone, z. B. Europa/Amsterdam. Datentyp: Zeichenfolge Standard: Keine |
[Tabelle : 8. Abfrageparameter]

{#wsd_search-GET-best_match__entry__28}

| Header | Beschreibung |
|-|-|
| Keine |   |
[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_search-GET-best_match__entry__32}{#wsd_search-GET-best_match__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#wsd_search-GET-best_match__entry__36}

| 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_search-GET-best_match__entry__40}{#wsd_search-GET-best_match__entry-200-status-code}{#wsd_search-GET-best_match__entry-401-status-code}{#wsd_search-GET-best_match__entry-404-status-code}{#wsd_search-GET-best_match__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_search-GET-best_match__entry__50}{#wsd_search-GET-best_match__hasMore-reserv-entry}{#wsd_search-GET-best_match__nextItemIndex-reserv-entry}{#wsd_search-GET-best_match__reservableContainers-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_building-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_campus-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_capacity-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_display_value-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_floor-reserv-entry}{#wsd_search-GET-best_match__reservableContainers_sys_id-reserv-container}{#wsd_search-GET-best_match__reservableUnit-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_area-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_area_display_value-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_area_sys_id-reserv-entry}{#wsd_search-GET-best_match__availableTimes-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_building-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_description-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_email-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_external_id-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_includedInResult-reserv-entry}{#wsd_search-GET-best_match__is_available-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_is_favorite-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_is_reservable-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_is_reserved-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_is_selected-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_location_type-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_location_type_name-reserv-entry}{#wsd_search-GET-best_match__reservableUnit_reservations-reserv-entry}{#wsd_search-GET-best_match__configuration_item-reserv-row}{#wsd_search-GET-best_match__is_collided-reserv-row}{#wsd_search-GET-best_match__reservableUnit_reservations_location-reserv-entry}

| Name | Beschreibung |
|-|-|
| Ergebnis | Gibt Ergebnisse für die beste reservierbare Übereinstimmung zurück. Datentyp: Objekt "result": { "floorsOfSelectedBuilding": [Array], "hasMore": Boolean, "nextItemIndex": Number, "reservableContainers": [Array], "reservableUnits": [Array] } |
| Ergebnis.StockwerkAusgewählteGebäude | Details zu den Stockwerken, auf denen sich das reservierbare Element befindet. Datentyp: Array von Objekten "floorsOfSelectedBuilding": [ { "display_value": "String", "external_id": "String", "name": "String", "sys_id": "String" } ] |
| Ergebnis.StockwerkAusgewählteGebäude.Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| Ergebnis.StockwerkAusgewählteGebäude.external_ID | Externer Bezeichner für das Stockwerk. Datentyp: Zeichenfolge |
| result.floorsOfSelectedBuilding.name | Name des Stockwerks, in dem sich das reservierbare Element befindet. Datentyp: Zeichenfolge |
| Ergebnis.StockwerkAusgewählteGebäude.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.hasWeitere | Kennzeichnung, die angibt, ob in den Rückgabeergebnissen weitere Reservierbare vorhanden sind. Mögliche Werte: * Wahr: Weitere reservierbare Elemente verfügbar. * Falsch: Keine weiteren reservierbaren Elemente verfügbar. Datentyp: Boolescher Wert |
| Ergebnis.nextItemIndex | Index für den nächsten abzurufenden reservierbaren Datensatz. Verwenden Sie diesen Wert, wenn Sie durch reservierbare Datensätze paginieren. Datentyp: Zahl |
| Ergebnis.reservierbar Container | Wird nur für reservierbare Module zurückgegeben, deren Feld „selection_type" auf festgelegt ist <kbd class="ph userinput">Container </kbd>. Ein Container ist eine Gruppierung ähnlicher Elemente, z. B. einer Gruppe von Schreibtischen. Datentyp: Array von Objekten "reservableContainers": [ { "building": {Object}, "campus": {Object}, "capacity": Number, "display_value": "String", "floor": {Object}, "image": {Object} "sys_id": "String" } ] |
| Ergebnis.reservierbarContainer.Gebäude | Details zum Gebäude, das dem reservierbaren Container zugeordnet ist. Datentyp: Objekt "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbarContainer.Gebäude.​Display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| result.reservableContainers.building.name | Name des Gebäudes. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Gebäude.sys_ID | SYS_ID des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.reservableContainers.campus | Details zum Campus, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "campus": { "display_value": "String", "name": "String", "sys_id": "String" } Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableContainers.campus.​Display_value | Anzeigenummer des Campus, auf dem sich das reservierbare Element befindet, z. B. East Bay. Datentyp: Zeichenfolge |
| result.reservableContainers.campus.name | Name des Campus. Datentyp: Zeichenfolge |
| result.reservableContainers.campus.sys_id | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableContainers.capacity | Maximale Anzahl von Personen für das reservierbare Element. Datentyp: Zahl |
| Ergebnis.reservableContainer.Display_value | Anzeigewert für den reservierbaren Container. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Stockwerk | Details zum Stockwerk, das dem reservierbaren Container zugeordnet ist. Datentyp: Objekt "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbarContainer.Stockwerk.​Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| result.reservableContainers.floor.name | Name des Stockwerks, in dem sich das reservierbare Element befindet. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Stockwerk.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbarContainers.Image | Details zu einem Bild, das das Layout für das zugehörige reservierbare Element darstellt. Datentyp: Objekt "image": { "link": "String", "sys_id": "String" } Tabelle: Images \[DB_image\] |
| result.reservableContainers.image.link | Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt. Datentyp: Zeichenfolge Tabelle: Images \[DB_image\] |
| Ergebnis.reservierbarContainers.image.sys_ID | SYS_ID des zugeordneten Bilddatensatzes. Datentyp: Zeichenfolge |
| Ergebnis.reservableContainer.sys_ID | SYS_ID des zugeordneten Containerdatensatzes. Datentyp: Zeichenfolge Tabelle: Die Tabelle, in der sich diese befindet, kann für jeden Containertyp konfiguriert werden. Standardmäßig befindet sie sich in der Bereichstabelle \[sn_wsd_core_area\]. |
| Ergebnis.reservierbare Einheiten | Details zu den reservierbaren Einheiten, die den angegebenen Suchkriterien entsprechen. Eine reservierbare Einheit ist ein einzelnes reservierbares Element, z. B. ein Schreibtisch oder ein Stuhl. Datentyp: Array von Objekten "reservableUnits": [ { "area": "String", "availableTimes": [Array], "building": {Object}, "campus": {Object}, "capacity": "String", "defaultPrivacyValue": Boolean, "description": "String", "email": "String", "external_id": "String", "floor": {Object}, "image": {Object}, "includedInResult": Boolean, "is_available": Boolean, "is_favorite": Boolean, "is_reservable": "String", "is_reserved": Boolean, "is_selected": Boolean, "location_type": {Object}, "name": "String", "number": "String", "order": "String", "require_approval": Boolean, "requires_check_in": Boolean, "reservable_quantity": "String", "showPrivacyOption": Boolean, "site": {Object}, "standard_services": [Array], "tableName": "String", "title": "String", "reservable_purposes": [Array], "reservations": [Array], "sys_id": "String" } ] |
| Ergebnis.reservierbarEinheiten.Bereich | Details zum Bereich, in dem sich das reservierbare Modul befindet. Datentyp: Objekt "area": { "display_value": "String", "sys_id": "String" } Tabelle: Bereich \[sn_wsd_core_area\] |
| Ergebnis.reservierbare Einheiten.Bereich.Display_Wert | Anzeigewert für den reservierbaren Modulbereich. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Bereich.sys_ID | SYS_ID des Bereichsdatensatzes, der dem reservierbaren Element zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.VerfügbarZeiten | Liste der Daten/Uhrzeiten, zu denen das zugehörige reservierbare Element verfügbar ist. Datentyp: Array |
| Ergebnis.reservierbarEinheiten.Gebäude | Details zum Gebäude, in dem sich das reservierbare Element befindet. Datentyp: Objekt "building": { "display_value": "String", "sys_id": "String" } Tabelle: Gebäude \[sn_wsd_core_building\] |
| Ergebnis.reservierbare Einheiten.Gebäude.Display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Gebäude.sys_ID | SYS_ID des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.reservableUnits.campus | Details zum Campus, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "campus": { "display_value": "String", "sys_id": "String" } Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableUnits.campus.display_value | Anzeigenummer des Campus, auf dem sich das reservierbare Element befindet, z. B. East Bay. Datentyp: Zeichenfolge |
| result.reservableUnits.campus.sys_id | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableUnits.capacity | Maximale Anzahl von Personen für das reservierbare Element. Datentyp: Zahl |
| result.reservableUnits.defaultPrivacyValue | Kennzeichnung, die die standardmäßige Datenschutzeinstellung für das reservierbare Element angibt. 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). Mögliche Werte: * Wahr: Die Datenschutzeinstellung für das reservierbare Element kann überschrieben werden. * Falsch: Die Datenschutzeinstellung für das reservierbare Element kann nicht überschrieben werden. Datentyp: Boolescher Wert |
| result.reservableUnits.description | Kurze Beschreibung des reservierbaren Elements. Datentyp: Zeichenfolge |
| result.reservableUnits.email | E-Mail-Adresse für das reservierbare Element. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.external_ID | Externe ID des reservierbaren Elements, das zum Synchronisieren eines in CMS zugeordneten Bereichs verwendet wird. Dieser Wert wird nur ausgefüllt, wenn diesem Standort eine Karte zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Stockwerk | Details zum Stockwerk, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "floor": { "display_value": "String", "sys_id": "String" } Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbare Einheiten.Stockwerk.Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Stockwerk.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbare Einheiten.Bild | Details zu einem Bild, das das Layout für das zugehörige reservierbare Element darstellt. Datentyp: Objekt "image": { "link": "String", "sys_id": "String" } Tabelle: Images \[DB_image\] |
| result.reservableUnits.image.link | Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt. Datentyp: Zeichenfolge Tabelle: Images \[DB_image\] |
| Ergebnis.reservierbare Einheiten.Image.sys_ID | SYS_ID des zugeordneten Bilddatensatzes. Datentyp: Zeichenfolge |
| result.reservableUnits.includedInResult | Kennzeichnung, die angibt, ob das aktuelle reservierbare Element in den Rückgabeergebnissen enthalten ist. Gültige Werte: * Wahr: In den Rückgabeergebnissen enthalten. * Falsch: Nicht in den Rückgabeergebnissen enthalten. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_available | Kennzeichnung, die angibt, ob das reservierbare Element für die Reservierung verfügbar ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Nicht verfügbar für Reservierung. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_Favorite | Kennzeichnung, die angibt, ob das reservierbare Element als einer der Favoriten des zugeordneten Anwenders gekennzeichnet ist. Gültige Werte: * Wahr: Favorit. * Falsch: Kein Favorit. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_reserable | Kennzeichnung, die angibt, ob dieses reservierbare Element reserviert werden kann. Hinweis: Wenn include_unavailable_itemsAbfrageparameter ist auf „wahr" festgelegt, nicht verfügbare Standorte werden ebenfalls zurückgegeben. Wenn in diesem Fall bereits ein Standort reserviert ist, dann wird is_availableParameter ist „falsch", aber is_reservableIst „wahr". Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Nicht verfügbar für Reservierung. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_reserved | Kennzeichnung, die angibt, ob das reservierbare Element bereits reserviert ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Bereits reserviert. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_selected | Kennzeichnung, die angibt, ob das reservierbare Element bereits reserviert ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Bereits reserviert. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.location_type | Details zum Typ des Standorts des reservierbaren Elements, z. B. Arbeitsplatz/Schreibtisch, Café oder Fitnessstudio. Datentyp: Objekt "location_type": { "display_value": "String", "name": "String", "sys_id": "String" } Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservableUnits.location_type.​Display_value | Anzeigewert des Standorttyps. Datentyp: Zeichenfolge |
| result.reservableUnits.location_type.name | Name des Standorttyps, z. B. Keller oder Speicher. Identisch mit Anzeigewert. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.location_type.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Bereichstyp \[sn_wsd_core_space_type\] |
| result.reservableUnits.name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Nummer | Eindeutiger Bezeichner des reservierbaren Elements. Dieser Wert ist visuell lesbarer als die sys_ID. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reihenfolge | Auftragsnummer für reservierbares Element. Datentyp: Zahl |
| Ergebnis.reservableUnits.require_Approval | Kennzeichnung, die angibt, ob die Reservierung des reservierbaren Elements eine Genehmigung erfordert. Mögliche Werte: * Wahr: Genehmigung erforderlich. * Falsch: Genehmigung ist nicht erforderlich. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.requires_Check_in | Kennzeichnung, die angibt, ob für das reservierbare Element der Anwender das Einchecken erfordert. Gültige Werte: * Wahr: Einchecken erforderlich. * Falsch: Einchecken ist nicht erforderlich. Datentyp: Boolescher Wert |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke | Details zum Zweck der Reservierung des zugehörigen reservierbaren Elements. Datentyp: Array von Objekten "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| Ergebnis.reservableUnits.reservable_purposes.​Name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke.​Kurzbeschreibung | Kurze Beschreibung des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke.​sys_ID | SYS_ID des reservierbaren Zweckdatensatzes. Datentyp: Zeichenfolge Tabelle: Reservierbarer Zweck \[sn_wsd_rsv_reservable_purpose\] |
| Ergebnis.reservierbarEinheiten.Reservierungen | Details zu den Reservierungen, die dem reservierbaren Element zugeordnet sind. Wird nur ausgefüllt, wenn include_reservations_within_daysAbfrageparameter ist „wahr" und „ reservation_idsParameter enthält Reservierungs-IDs, d. h. für dieses reservierbare Element sind bereits Reservierungen vorhanden. Datentyp: Array von Objekten "reservations": [ { "configuration_item": "String", "end": "String", "is_collided": Boolean, "location": {Object}, "number": "String", "requested_for": {Object}, "reservation_purpose": {Object}, "start": "String", "state": {Object}, "subject": "String", "sys_id": "String" } ] |
| Ergebnis.reservableEinheiten.Reservierungen.​Configuration_item | Konfigurationselemente, die der Reservierung entsprechen. Datentyp: Zeichenfolge Tabelle: Konfigurationselement \[cmdb_ci\] |
| Ergebnis.reservierbarEinheiten.Reservierungen.Ende | Enddatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC: jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.reservableUnits.Reservierungen.is_Collided | Kennzeichnung, die angibt, ob die Reservierung mit der Start- und Endzeit der Suche kollidiert. Dies gibt an, dass der zugeordnete reservierbare Standort bereits für die angegebene Suchzeitspanne reserviert ist. Mögliche Werte: * Wahr: Kollision. * Falsch: Keine Kollision. Datentyp: Boolescher Wert |
| Ergebnis.reservierbarEinheiten.Reservierungen.Standort | Details zum Standort der Reservierung. Datentyp: Objekt "location": { "location": "String", "timezone": {Object} } |
| Ergebnis.reservierbarEinheiten.Reservierungen.Standort.​Standort | SYS_ID des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone | Details zur Zeitzone, die dem Standort zugeordnet ist. Datentyp: Objekt "timezone": { "displayValue": "String", "value": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone.Anzeigewert | Anzeigewert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone.Wert | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Nummer | Eindeutiger Bezeichner des reservierbaren Elements. Dieser Wert ist visuell lesbarer als die sys_ID. Datentyp: Zeichenfolge |
| Ergebnis.reservableEinheiten.Reservierungen.​Angefordert_für | Details zur Person, für die die Reservierung angefordert wurde. Datentyp: Objekt "requested_for": { "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.​requested_for.name | Name des Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Angefordert_für.sys_ID | SYS_ID des Anwenders, für den die Reservierung angefordert wird. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Ergebnis.reservierbare Einheiten.Reservierungen. Reservierungszweck ​ | Details zum Zweck der Reservierung. Datentyp: Objekt "reservation_purpose": { "display_value": "String", "value": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Reservation_purpose.Display_value | Anzeigewert für den Zweck der Reservierung, z. B. Unternehmensbesprechung. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Reservation_purpose.value | Interner Wert für den Zweck der Reservierung, z. B. Company_Meeting. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Start | Startdatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC -- jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.reservierbarEinheiten.Reservierungen.Status | Details zum Status der Reservierung für den Standort. Datentyp: Objekt "state": { "display_value": "String", "value": "String" } |
| Ergebnis.reservableEinheiten.Reservierungen.Status.​Display_value | Anzeigewert für den aktuellen Status der Reservierung, z. B. bestätigt. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.Status.Wert | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Betreff | Betreff der Reservierung. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.sys_ID | Erforderlich. SYS_ID des Reservierungsdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Ergebnis.reservierbare Einheiten.reservierbare_Menge | Maximale Anzahl, mit der das zugeordnete reservierbare Element für dieselbe Zeit reserviert werden kann. Dieser Wert wird verwendet, wenn einem Bereich Arbeitsbereiche zugewiesen werden. Datentyp: Ganzzahl |
| Ergebnis.reservierbare Einheiten.showPrivacyOption | Kennzeichnung, die angibt, ob ein Mitarbeiter die Datenschutzeinstellungen für das zugehörige reservierbare Element überschreiben kann. 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: Datenschutzeinstellungen können überschrieben werden. * Falsch: Datenschutzeinstellung kann nicht überschrieben werden. Datentyp: Boolescher Wert |
| result.reservableUnits.site | Details zum Standort, an dem sich das reservierbare Element befindet. Datentyp: Objekt "site": { "display_value": "String", "sys_id": "String" } Tabelle: Site \[sn_wsd_core_site\] |
| Ergebnis.reservierbare Einheiten.Site.Display_value | Anzeigewert der Website. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Site.sys_ID | SYS_ID des zugeordneten Site-Datensatzes. Datentyp: Zeichenfolge Tabelle: Site \[sn_wsd_core_site\] |
| Ergebnis.reservableUnits.Standard_Services | Zugehörige Standardservices, z. B. Flipchart, Projektorbildschirm, Whiteboard und Markierungen. Datentyp: Array von Objekten "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| Result.reservableUnits.Standard_Services.​Font_Awesome_icon | Name des Miniaturansichtssymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| result.reservableUnits.standard_services.name | Name des Miniaturansichtssymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.Standard_Services.​Short_description | Kurze Beschreibung des Standardservice. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.Standard_Services.sys_ID | SYS_ID des Standardservicedatensatzes. Datentyp: Zeichenfolge Tabelle: Standardservice \[sn_wsd_rsv_standard_service\] |
| Ergebnis.reservierbare Einheiten.sys_ID | SYS_ID des reservierbaren Datensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservableEinheiten.tableName | Name der Tabelle, in der sich der reservierbare Datensatz befindet. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Titel | Titel des reservierbaren Elements. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/best_match?q=building%3D9e0364cedb3650106c731dcd1396192b&start=2023-01-04T07%3A00%3A00Z&time_slot=d5331cf2dbb5f01038e42b24ca961906&end=2023-01-04T17%3A00%3A00Z&best_match_count=1&reservable_module=2b636b7e1b4e60103523ff751a4bcbe2&timezone=Europe%2FAmsterdam" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": {
        "hasMore": false,
        "reservableUnits": [
          {
            "sys_id": "fe1f744edb7650106c731dcd139619ca",
            "external_id": null,
            "email": null,
            "name": "Aspen",
            "title": "Aspen",
            "description": "A room with large windows, dark leather seats and a large wooden table.",
            "image": {
              "sys_id": "41c74902dbb650106c731dcd13961944",
              "link": "41c74902dbb650106c731dcd13961944.iix"
            },
            "number": "ROOM0000903",
            "site": {
              "sys_id": "628eec06db7650106c731dcd139619dd",
              "display_value": "North America"
            },
            "campus": {
              "sys_id": "82b2a0cedb3650106c731dcd139619e9",
              "display_value": "California Campus"
            },
            "building": {
              "sys_id": "94e264cedb3650106c731dcd13961919",
              "display_value": "CAL-B1"
            },
            "floor": {
              "sys_id": "2f554296dbba10106c731dcd139619ed",
              "display_value": "Floor 2"
            },
            "area": null,
            "capacity": "16",
            "reservable_quantity": null,
            "location_type": {
              "sys_id": "20713b83eb512010b89bfdfc9c522899",
              "display_value": "Room",
              "name": "Room"
            },
            "order": null,
            "requires_check_in": null,
            "is_reservable": "1",
            "tableName": "sn_wsd_core_room",
            "require_approval": false,
            "standard_services": [
              {
                "sys_id": "abd0c18edb7650106c731dcd13961965",
                "name": "Projector screen",
                "short_description": "Connect laptop to screen (HDMI and DVI)",
                "font_awesome_icon": "fa-caret-square-o-right"
              }
            ],
            "reservable_purposes": [
              {
                "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
                "name": "Board room",
                "short_description": null
              }
            ],
            "is_available": true,
            "reservations": [
              {
                "sys_id": "5fe65830874bc9106342b846dabb352b",
                "number": "WRES0001001",
                "location": {
                  "location": "fe1f744edb7650106c731dcd139619ca",
                  "timezone": {
                    "value": "US/Pacific",
                    "displayValue": "US/Pacific"
                  }
                },
                "configuration_item": null,
                "start": "2022-04-23T08:30:00Z",
                "end": "2022-04-23T09:30:00Z",
                "subject": null,
                "reservation_purpose": {
                  "value": "meeting",
                  "display_value": "Meeting"
                },
                "state": {
                  "value": "confirmed",
                  "display_value": "Confirmed"
                },
                "is_collided": false,
                "requested_for": {
                  "sys_id": "2de07e1887cb89106342b846dabb35fe",
                  "name": "Workplace User"
                }
              },
              {
                "sys_id": "af075c30874bc9106342b846dabb3572",
                "number": "WRES0001002",
                "location": {
                  "location": "fe1f744edb7650106c731dcd139619ca",
                  "timezone": {
                    "value": "US/Pacific",
                    "displayValue": "US/Pacific"
                  }
                },
                "configuration_item": null,
                "start": "2022-04-23T23:00:00Z",
                "end": "2022-04-24T00:00:00Z",
                "subject": null,
                "reservation_purpose": {
                  "value": "meeting",
                  "display_value": "Meeting"
                },
                "state": {
                  "value": "confirmed",
                  "display_value": "Confirmed"
                },
                "is_collided": false,
                "requested_for": {
                  "sys_id": "2de07e1887cb89106342b846dabb35fe",
                  "name": "Workplace User"
                }
              }
            ],
            "availableTimes": [
              [
                "2022-04-23 07:00:00",
                "2022-04-23 08:30:00"
              ],
              [
                "2022-04-23 09:30:00",
                "2022-04-23 23:00:00"
              ],
              [
                "2022-04-24 00:00:00",
                "2022-04-24 06:59:59"
              ]
            ],
            "is_favorite": false
          }
        ],
        "reservableContainers": [],
        "nextItemIndex": -1,
        "floorsOfSelectedBuilding": [
          {
            "sys_id": "2f554296dbba10106c731dcd139619ed",
            "display_value": "Floor 2",
            "external_id": null,
            "name": "Floor 2"
          }
        ]
      }
    }{
      "result": {
        "hasMore": false,
        "reservableUnits": [
          {
            "sys_id": "32f2a98adb7210106c731dcd13961972",
            "external_id": null,
            "wsd_email": null,
            "name": "B1-03-04",
            "title": "B1-03-04",
            "description": "Desk reserved for the Team-C. After 10am, free to reserve for everyone.",
            "image": {
              "sys_id": "57b42dcadb7210106c731dcd13961945",
              "link": "57b42dcadb7210106c731dcd13961945.iix"
            },
            "number": "SPCE0009018",
            "site": {
              "sys_id": "b17220cedb3650106c731dcd1396197a",
              "display_value": "Western Europe"
            },
            "campus": {
              "sys_id": "44d2e0cedb3650106c731dcd13961988",
              "display_value": "Amsterdam Campus"
            },
            "building": {
              "sys_id": "9e0364cedb3650106c731dcd1396192b",
              "display_value": "AMS-B1"
            },
            "floor": {
              "sys_id": "5373a8cedb3650106c731dcd1396198a",
              "display_value": "Floor 3"
            },
            "area": {
              "sys_id": "410ff04edb7650106c731dcd13961973",
              "display_value": "Desks C1"
            },
            "capacity": "1",
            "reservable_quantity": null,
            "location_type": {
              "sys_id": "5f017383eb512010b89bfdfc9c5228c8",
              "display_value": "Workspace/Desk",
              "name": "Workspace/Desk"
            },
            "order": null,
            "requires_check_in": null,
            "is_reservable": "1",
            "tableName": "sn_wsd_core_space",
            "require_approval": false,
            "is_available": true,
            "reservations": [],
            "availableTimes": [
              [
                "2023-01-04 07:00:00",
                "2023-01-04 17:00:00"
              ]
            ],
            "showPrivacyOption": false,
            "defaultPrivacyValue": false,
            "container": {
              "sys_id": "410ff04edb7650106c731dcd13961973",
              "display_value": "Desks C1",
              "floor": {
                "sys_id": "5373a8cedb3650106c731dcd1396198a",
                "display_value": "Floor 3",
                "name": "Floor 3"
              },
              "building": {
                "sys_id": "9e0364cedb3650106c731dcd1396192b",
                "display_value": "AMS-B1",
                "name": "AMS-B1"
              },
              "campus": {
                "sys_id": "44d2e0cedb3650106c731dcd13961988",
                "display_value": "Amsterdam Campus",
                "name": "Amsterdam Campus"
              },
              "capacity": 6,
              "image": {
                "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
                "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
              }
            },
            "includedInResult": true,
            "is_favorite": true
          }
        ],
        "reservableContainers": [
          {
            "sys_id": "410ff04edb7650106c731dcd13961973",
            "display_value": "Desks C1",
            "floor": {
              "sys_id": "5373a8cedb3650106c731dcd1396198a",
              "display_value": "Floor 3",
              "name": "Floor 3"
            },
            "building": {
              "sys_id": "9e0364cedb3650106c731dcd1396192b",
              "display_value": "AMS-B1",
              "name": "AMS-B1"
            },
            "campus": {
              "sys_id": "44d2e0cedb3650106c731dcd13961988",
              "display_value": "Amsterdam Campus",
              "name": "Amsterdam Campus"
            },
            "capacity": 6,
            "image": {
              "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
              "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
            }
          }
        ],
        "nextItemIndex": -1,
        "floorsOfSelectedBuilding": [
          {
            "sys_id": "5373a8cedb3650106c731dcd1396198a",
            "display_value": "Floor 3",
            "external_id": null,
            "name": "Floor 3"
          }
        ]
      }

## WSD-Suche: RUFT /api/sn_wsd_rsv/search/overlapping_reservation AB {#ariaid-title4}

Bestimmt, ob eine überlappende Reservierung basierend auf den übergebenen Parametern vorhanden ist.
<br />

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/overlapping_reservation

Standard-URL: /api/sn_wsd_rsv/search/overlapping_reservation  
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_search-GET-overlap_resv__entry__2}{#wsd_search-GET-overlap_resv__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_search-GET-overlap_resv__entry__6}

| Name | Beschreibung |
|-|-|
| end | Erforderlich. Endzeit, die zum Überprüfen auf überlappende Reservierungen verwendet werden soll. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TTTHH:MM:SSZ |
| Recurring_pattern | Details zum wiederkehrenden Muster für die Reservierung. Datentyp: Objekt "recurring_pattern": { "duration": Number, "options": {Object}, "repeats": "String", "startDate":"String" } |
| Recurring_pattern.duration | Dauer der Überprüfung. Datentyp: Zahl Einheit: Sekunden |
| Recurring_pattern.options | Details zu den Optionen, die der wiederkehrenden Reservierung zugeordnet sind. Datentyp: Objekt "options": { "count": Number, "daysOfWeek": "String", "every": Number } |
| Recurring_pattern.options.count | Anzahl der Wiederholungen des Musters. Datentyp: Zahl |
| Recurring_pattern.options.daysOfWeek | Wochentage, an denen auf Überschneidungen überprüft werden soll. Gültige Werte: * 1 = Montag * 2 = Dienstag * 3 = Mittwoch * 4 = Donnerstag * 5 = Freitag * 6 = Samstag * 7 = Sonntag Um beispielsweise Dienstag, Donnerstag und Freitag anzugeben, übergeben Sie 245 (kein Trennzeichen). Datentyp: Zeichenfolge |
| Recurring_pattern.options.every | Zu überprüfendes Musterwiederholungsintervall. Beispiel: Wenn dieser Wert ist <kbd class="ph userinput">2 </kbd>, Überprüft das Wiederholungsmuster basierend auf der Auswahl in repeatsParameter, z. B. „jeder zweite Tag" oder „jede zweite Woche". Datentyp: Zahl |
| Recurring_pattern.options.repeats | Wiederholtes Muster für die Überprüfung der Reservierungsüberschneidung. Mögliche Werte: (Groß-/Kleinschreibung beachten) * täglich * monatlich * wöchentlich * jährlich Datentyp: Zeichenfolge |
| Reservierbare_ID | SYS_ID des reservierbaren Moduls, um nach überlappenden Reservierungen zu suchen. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| Reservierungs-ID | SYS_ID der Reservierung, die auf Überschneidungen überprüft werden soll. Dieser Wert ist im Bearbeitungs-Flow von übergeordneten Elementen mit mehreren oder Gruppen erforderlich. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Shift_Info_object | Details der Schicht, die auf Überschneidungen überprüft werden soll. 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: Objekt "shift_info_object": { "applyToShift": Boolean, "shift": "String", "timezone": "String" } |
| Shift_info_object.applyToShift | Kennzeichnung, die angibt, ob schichtbasierte Reservierungen für das reservierbare Modul aktiviert sind. Gültige Werte: * Wahr: Schichtbasierte Reservierungen zulassen. * Falsch: Schichtbasierte Reservierungen nicht zulassen. Datentyp: Boolescher Wert |
| Shift_info_object.Shift | SYS_ID der Schicht, die der Reservierung zugeordnet werden soll. Wenn dieser Parameter übergeben wird, wird endParameter ist nicht erforderlich. Datentyp: Zeichenfolge Tabelle:Schicht \[sn_wsd_core_shift\] |
| Shift_info_object.timezone | Zeitzone der Schicht, um auf Überschneidungen zu überprüfen. Datentyp: Zeichenfolge |
| start | Erforderlich. Startzeit, die zum Überprüfen auf überlappende Reservierungen verwendet werden soll. Datentyp: Zeichenfolge FORMAT: JJJ-MM-TTTHH:MM:SSZ |
| user_id | Erforderlich. SYS_ID des Anwenders, der auf überlappende Reservierungen überprüft werden soll. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
[Tabelle : 14. Abfrageparameter]

{#wsd_search-GET-overlap_resv__entry__40}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### 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_search-GET-overlap_resv__entry__44}{#wsd_search-GET-overlap_resv__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen.]

{#wsd_search-GET-overlap_resv__entry__48}

| 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_search-GET-overlap_resv__entry__52}{#wsd_search-GET-overlap_resv__entry-200-status-code}{#wsd_search-GET-overlap_resv__entry-400-status-code}{#wsd_search-GET-overlap_resv__entry-401-status-code}{#wsd_search-GET-overlap_resv__entry-404-status-code}{#wsd_search-GET-overlap_resv__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 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 (JSON oder XML)

{#wsd_search-GET-overlap_resv__entry__64}

| Name | Beschreibung |
|-|-|
| Ergebnisse | Details der Ergebnisse der Überlappungsprüfung. Datentyp: Objekt "results": { "isOverlapped": Boolean, "reservableId": "String" } |
| Ergebnisse.isOverlapped | Kennzeichnung, die angibt, ob eine überlappende Reservierung vorhanden ist. Gültige Werte: * Wahr: Überlappende Reservierung vorhanden. * Falsch: Überlappende Reservierung ist nicht vorhanden. Datentyp: Boolescher Wert |
| Ergebnisse.reservableId | Im Falle einer Gruppenreservierung die sys_ID des reservierbaren Elements, für das die Überschneidung auftritt. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie auf eine Reservierungsüberschneidung für einen bestimmten Anwender und für einen bestimmten Zeitraum überprüft wird, der durch gekennzeichnet ist startUnd endParameter.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/search/overlapping_reservation?user_id=2e617fecc3d365101e38b23bb00131ec&end=2023-06-19T8:00:00Z&start=2023-06-19T07:00:00Z" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

Ergebnisse zurückgeben:

    {
    "results": {
      "isOverlapped": True,
      "reservableId": ""
      }
    }

## WSD-Suche: RUFT /api/sn_wsd_rsv/search/reservierbar AB {#ariaid-title5}

Sucht anhand einer angegebenen reservierbaren Modellkonfiguration nach verfügbaren reservierbaren Elementen.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/reservierbar

Standard-URL: /api/sn_wsd_rsv/search/reservierbar  
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_search-GET-reservable__entry__2}{#wsd_search-GET-reservable__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 : 19. Pfad-Parameter]

{#wsd_search-GET-reservable__entry__6}{#wsd_search-GET-reservable__end-query-reserv-entry}{#wsd_search-GET-reservable__ignore_same_day_validation-reserv-entry}{#wsd_search-GET-reservable__include_reservable_purposes-reserv-entry}{#wsd_search-GET-reservable__include_reservations_within_days-reserv-entry}{#wsd_search-GET-reservable__include_standard_services-reserv-entry}{#wsd_search-GET-reservable__neighborhood-reserv-entry}{#wsd_search-GET-reservable__q-reserv-entry}{#wsd_search-GET-reservable__reservable_module-reserv-entry}{#wsd_search-GET-reservable__reservation_ids-reserv-entry}{#wsd_search-GET-reservable__schedule_view_obj-reserv-entry}{#wsd_search-GET-reservable__schedule_view_obj-schedule_view_date-reserv-entry}{#wsd_search-GET-reservable__schedule_view_obj-timezone-entry}{#wsd_search-GET-reservable__start-query-reserv-entry}{#wsd_search-GET-reservable__shift-update_reserv-entry}{#wsd_search-GET-reservable__timezone_q_parm-reserv-query}

| Name | Beschreibung |
|-|-|
| end | Erforderlich. Endzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss nach dem in angegebenen Wert liegen startParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| Exclude_reservables | Liste von einer oder mehreren sys_IDs von reservierbaren Elementen, die aus den Suchergebnissen ausgeschlossen werden sollen. Datentyp: Zeichenfolge oder Array Tabelle: Die Tabelle, in der sich diese sys_IDs befinden, wird im Feld „Reservierbares Modul" in der Tabelle „Reservierbares Modul" \[sn_wsd_rsv_reservable_module\] angegeben. Es kann sich entweder um die Tabelle „Bereich" \[sn_wsd_core_space\] oder „Raum \[sn_wsd_core_room\]" handeln. |
| ignore_same_day_validation | Kennzeichnung, die angibt, ob die Reservierungssuche die Änderung der Datumsvalidierung zwischen den Start- und Endparametern ignoriert. Gültige Werte: * Wahr: Validierung des Change-Datums ignorieren. * Falsch: Ignorieren Sie die Validierung des Change-Datums nicht. Datentyp: Boolescher Wert Standard: Falsch |
| Include_reservable_purposes | Kennzeichnung, die angibt, ob der Zweck der Reservierung des Arbeitsplatzstandorts für jedes reservierbare Element in den Rückgabeergebnissen zurückgegeben werden soll. Gültige Werte: * Wahr: Reservierbare Zwecke zurückgeben. * Falsch: Geben Sie die reservierbaren Zwecke nicht zurück. Datentyp: Boolescher Wert Standard: Falsch Tabelle: Reservierbarer Zweck \[sn_wsd_rsv_reservable_purpose\] |
| include_reservations_within_days | Kennzeichnung, die angibt, ob alle freien Zeitfenster mit verfügbaren Zeiten in der Antwort für jedes reservierbare Element für den ganzen Tag zurückgegeben werden sollen. Gültige Werte: * Wahr: Gibt alle freien Slots zurück. * Falsch: Nicht alle freien Slots zurückgeben. Datentyp: Boolescher Wert Standard: Falsch |
| Include_Standard_​-Services | Kennzeichnung, die angibt, ob die Standardserviceinformationen in der Antwort zurückgegeben werden sollen. Diese Informationen befinden sich in der Tabelle „Standardservice" \[sn_wsd_rsv_standard_service\]. Ein Standardservice beschreibt grundlegende Vorkehrungen, die bei der Reservierung mit einem reservierbaren Arbeitsplatzelement verfügbar sind, z. B. Whiteboards, zusätzliche Monitore und ähnliche Services. Weitere Informationen zu Standardservices finden Sie unter [Standardservices](https://www.servicenow.com/docs/access?context=standard-service&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Gültige Werte: * Wahr: Standardserviceinformationen zurückgeben. * Falsch: Geben Sie die Standardserviceinformationen nicht zurück. Datentyp: Boolescher Wert Standard: Falsch |
| near_by_location_id | Erforderlich, wenn rsv_pathParameter ist auf festgelegt <kbd class="ph userinput">browse_near_a_person </kbd>. SYS_ID des Standorts, der in der codierten Abfrage verwendet werden soll. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Arbeitsbereich | Erforderlich, wenn `rsv_path `Parameter ist auf festgelegt <kbd class="ph userinput">Browse_by_Workspace </kbd>. Nur verfügbar, wenn das Plugin „Platzmanagement" (sn_wsd_spc_mgmt_neighborhood) aktiviert ist. SYS_ID des Arbeitsbereichsdatensatzes, der in der codierten Abfrage verwendet werden soll. Weitere Informationen zu Platzreservierungen im Arbeitsbereich finden Sie unter [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=yokohama&pubname=yokohama-employee-service-management&ft:locale=en-US). Datentyp: Zeichenfolge Tabelle: Arbeitsbereich \[sn_wsd_spcmgmt_neighborhood\] |
| Next_item_index | Index des nächsten abzurufenden Elements. Übergeben Sie diesen Parameter beim Paginieren der Rückgabeergebnisse. Datentyp: Zahl Standard: 0 |
| page_size | Maximale Anzahl von Datensätzen, die in den Rückgabeergebnissen zurückgegeben werden sollen. Datentyp: Zahl Standard: 6 |
| q | Erforderlich. Codierte Abfrage, die zum Filtern der Suchergebnisse verwendet werden soll. In dieser Abfrage müssen Sie die sys_ID des Gebäudes angeben, und Sie können Parameter wie Stockwerk, Fläche, Kapazität, Standardservices und reservierbare Zwecke angeben. Alle übergebenen Parameter müssen sys_IDs sein, mit Ausnahme der Kapazität, die eine Zahl ist. Beispiel: `q=Building=94e264cedb3650106c731dcd13961919​^floorINfc7368cedb3650106c731dcd13961902​^Capacity>=1​^Standard_Services=55c0818edb7650106c731dcd13961904​^reservable_purposes=d6e5cd1ba4e01061904 ` Sie finden diese Informationen in den folgenden Tabellen: * Bereich: sn_wsd_core_area * Gebäude: sn_wsd_core_building * Stockwerk: sn_wsd_core_floor * Reservierbare Zwecke: sn_wsd_rsv_reservable_purpose * Standardservices: sn_wsd_rsv_standard_service Datentyp: Zeichenfolge |
| Reservierbar_Modul | Erforderlich. SYS_ID des reservierbaren Moduls, das in die Suche aufgenommen 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)Gruppiert ähnliche Typen von Arbeitsplatzelementen. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_rsv_reservable_module\] |
| Reservation_IDs | Kommagetrennte Liste der vorhandenen Reservierungs-sys_IDs. Übergeben Sie diesen Parameter, wenn Sie die zugehörigen Reservierungen bearbeiten möchten. Die Zeit, die für diese sys_IDs für die entsprechenden reservierbaren Elemente gesperrt ist, wird als verfügbar behandelt. Datentyp: Zeichenfolge Standard: Keine Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| rsv_path | Reservierungspfad, der auf die Suche angewendet werden soll. Gültige Werte: * Browse_all: Durchsuchen Sie alle reservierbaren Elemente. * Browse_by_area: Durchsuchen Sie die reservierten Elemente in der Nähe eines bestimmten Standorts. Ein Bereichsbezeichner muss in der codierten Abfrage übergeben werden ( qParameter). * Browse_by_Workspace: Suchen Sie die reservierten Elemente in der Nähe des in angegebenen Arbeitsbereichs neighborhoodParameter. * browse_near_a_person: Suchen Sie die reservierten Elemente in der Nähe des Arbeitsplatzstandorts der in angegebenen Person near_by_location_idParameter. Datentyp: Zeichenfolge Standard: Browse_all |
| Schedule_View_obj | Details zur zurückzugebenden Zeitplanansicht. Übergeben Sie dieses Objekt, wenn Sie 24-Stunden-Verfügbarkeitsdaten für Reservierungen benötigen, die mehr als einen Tag umfassen. Die Rückgabeergebnisse enthalten nur verfügbare Zeiten und Reservierungen für das angegebene Datum. Damit diese Funktionalität ordnungsgemäß funktioniert, die Parameter ignore_same_day_validationUnd include_reservations_within_daysMuss auf festgelegt werden <kbd class="ph userinput">Wahr </kbd>. Datentyp: Objekt "schedule_view_obj": { "schedule_view_date": "String", "timezone": "String" } |
| schedule_view_obj.schedule_view_date | Datum, für das mit der Rückgabe der Reservierungsverfügbarkeit begonnen werden soll. Dieses Datum muss sich in der in angegebenen Zeitzone befinden schedule_view_obj.timezoneParameter. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT |
| Schedule_View_obj.timezone | Zeitzone wird erstellt, die zum Bestimmen der zurückzugebenden Reservierungsverfügbarkeitsdaten verwendet werden soll. Beispiel: USA/Pazifik. Datentyp: Zeichenfolge |
| start | Erforderlich. Startzeit, die für die Suche nach verfügbaren reservierbaren Modulen verwendet werden soll. Dieser Wert muss vor dem in angegebenen Wert liegen endParameter. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| 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\] |
| sort_by | Gewünschte Sortierreihenfolge der zurückgegebenen reservierbaren Elemente. Gültige Werte: * A_z: Aufsteigende Sortierreihenfolge. * Favoriten_First: Zuerst sortiert nach den bevorzugten reservierbaren Arbeitsplätzen des Anwenders, aufsteigend für den Rest. * z_A: Absteigende Sortierreihenfolge. Datentyp: Zeichenfolge Standard: A_z |
| Feld | Bevorzugte Zeitzone, z. B. Europa/Amsterdam. Datentyp: Zeichenfolge Standard: Keine |
[Tabelle : 20. Abfrageparameter]

{#wsd_search-GET-reservable__entry__50}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. 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_search-GET-reservable__entry__54}{#wsd_search-GET-reservable__accept-reserv-entry}

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

{#wsd_search-GET-reservable__entry__58}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. 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_search-GET-reservable__entry__62}{#wsd_search-GET-reservable__entry-200-status-code}{#wsd_search-GET-reservable__entry-401-status-code}{#wsd_search-GET-reservable__entry-404-status-code}{#wsd_search-GET-reservable__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 : 24. Statuscodes]

### Antworttext-Parameter

{#wsd_search-GET-reservable__entry__72}{#wsd_search-GET-reservable__hasMore-reserv-entry}{#wsd_search-GET-reservable__nextItemIndex-reserv-entry}{#wsd_search-GET-reservable__reservableContainers-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_building-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_campus-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_capacity-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_display_value-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_floor-reserv-entry}{#wsd_search-GET-reservable__reservableContainers_sys_id-reserv-container}{#wsd_search-GET-reservable__reservableUnit-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_area-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_area_display_value-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_area_sys_id-reserv-entry}{#wsd_search-GET-reservable__availableTimes-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_building-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_description-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_email-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_external_id-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_includedInResult-reserv-entry}{#wsd_search-GET-reservable__is_available-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_is_favorite-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_is_reservable-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_is_reserved-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_is_selected-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_location_type-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_location_type_name-reserv-entry}{#wsd_search-GET-reservable__reservableUnit_reservations-reserv-entry}{#wsd_search-GET-reservable__configuration_item-reserv-row}{#wsd_search-GET-reservable__is_collided-reserv-row}{#wsd_search-GET-reservable__reservableUnit_reservations_location-reserv-entry}

| Name | Beschreibung |
|-|-|
| Ergebnis | Gibt Ergebnisse für die angegebene Suche zurück. Datentyp: Objekt "result": { "filter": {Object}, "hasMore": Boolean, "nextFavIndex": Number, "nextItemIndex": Number, "reservableContainers": [Array], "reservableUnits": [Array], "totalProcessed": Number } |
| Ergebnis.Filter | Details zu den Stockwerken, Standardservices und reservierbaren Zwecken der reservierbaren Elemente. Wenn include_standard_servicesOder include_reservable_purposesParameter sind auf „falsch" festgelegt, standard_servicesUnd reservable_purposesSind leere Arrays. Datentyp: Objekt "filter": { "floors": [Array], "reservable_purposes": [Array], "standard_services": [Array] } |
| Ergebnis.Filter.Stockwerke | Details zum Stockwerk, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "floors": [ { "display_value": "String", "sys_id": "String" } ] |
| Ergebnis.Filter.Stockwerke.Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| Ergebnis.Filter.Stockwerke.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.Filter.Standard_Services | Wird nur ausgefüllt, wenn include_standard_servicesParameter ist auf „wahr" festgelegt. Zugehörige Standardservices, z. B. Flipchart, Projektorbildschirm, Whiteboard und Markierungen. Datentyp: Array von Objekten "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| Ergebnis.Filter.Standard_Services.​Font_Awesome_icon | Name des Miniaturansichtssymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| result.filter.standard_services.name | Name des Standardservice. Datentyp: Zeichenfolge |
| Ergebnis.Filter.Standard_Services.short_description | Kurze Beschreibung des Standardservice. Datentyp: Zeichenfolge |
| Ergebnis.Filter.Standard_Services.sys_ID | SYS_ID des Standardservicedatensatzes. Datentyp: Zeichenfolge Tabelle: Standardservice \[sn_wsd_rsv_standard_service\] |
| Ergebnis.Filter.reservierbare_Zwecke | Details zum Zweck der Reservierung des zugehörigen reservierbaren Elements. Datentyp: Array von Objekten "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.filter.reservable_purposes.name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.Filter.reservierbare_Zwecke.​Short_description | Kurze Beschreibung des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.Filter.reservierbare Zwecke.sys_ID | SYS_ID des reservierbaren Zweckdatensatzes. Datentyp: Zeichenfolge Tabelle: Reservierbarer Zweck \[sn_wsd_rsv_reservable_purpose\] |
| Ergebnis.hasWeitere | Kennzeichnung, die angibt, ob in den Rückgabeergebnissen weitere Reservierbare vorhanden sind. Mögliche Werte: * Wahr: Weitere reservierbare Elemente verfügbar. * Falsch: Keine weiteren reservierbaren Elemente verfügbar. Datentyp: Boolescher Wert |
| Ergebnis.nextFavIndex | Index für den nächsten Favoriten, der für den Anwender reserviert werden kann. Verwenden Sie diesen Wert, wenn Sie durch die bevorzugten reservierbaren Elemente des Anwenders paginieren. Datentyp: Zahl |
| Ergebnis.nextItemIndex | Index für den nächsten abzurufenden reservierbaren Datensatz. Verwenden Sie diesen Wert, wenn Sie durch reservierbare Datensätze paginieren. Datentyp: Zahl |
| Ergebnis.reservierbar Container | Wird nur für reservierbare Module zurückgegeben, deren Feld „selection_type" auf festgelegt ist <kbd class="ph userinput">Container </kbd>. Ein Container ist eine Gruppierung ähnlicher Elemente, z. B. einer Gruppe von Schreibtischen. Datentyp: Array von Objekten "reservableContainers": [ { "building": {Object}, "campus": {Object}, "capacity": Number, "display_value": "String", "floor": {Object}, "image": {Object} "sys_id": "String" } ] |
| Ergebnis.reservierbarContainer.Gebäude | Details zum Gebäude, das dem reservierbaren Container zugeordnet ist. Datentyp: Objekt "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbarContainer.Gebäude.​Display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| result.reservableContainers.building.name | Name des Gebäudes. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Gebäude.sys_ID | SYS_ID des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.reservableContainers.campus | Details zum Campus, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "campus": { "display_value": "String", "name": "String", "sys_id": "String" } Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableContainers.campus.​Display_value | Anzeigenummer des Campus, auf dem sich das reservierbare Element befindet, z. B. East Bay. Datentyp: Zeichenfolge |
| result.reservableContainers.campus.name | Name des Campus. Datentyp: Zeichenfolge |
| result.reservableContainers.campus.sys_id | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableContainers.capacity | Maximale Anzahl von Personen für das reservierbare Element. Datentyp: Zahl |
| Ergebnis.reservableContainer.Display_value | Anzeigewert für den reservierbaren Container. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Stockwerk | Details zum Stockwerk, das dem reservierbaren Container zugeordnet ist. Datentyp: Objekt "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbarContainer.Stockwerk.​Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| result.reservableContainers.floor.name | Name des Stockwerks, in dem sich das reservierbare Element befindet. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarContainer.Stockwerk.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbarContainers.Image | Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt. Datentyp: Zeichenfolge Tabelle: Images \[DB_image\] |
| result.reservableContainers.image.link | Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt. Datentyp: Zeichenfolge Tabelle: Images \[DB_image\] |
| Ergebnis.reservierbarContainers.image.sys_ID | SYS_ID des zugeordneten Bilddatensatzes. Datentyp: Zeichenfolge |
| Ergebnis.reservableContainer.sys_ID | SYS_ID des zugeordneten Containerdatensatzes. Datentyp: Zeichenfolge Tabelle: Die Tabelle, in der sich diese befindet, kann für jeden Containertyp konfiguriert werden. Standardmäßig befindet sie sich in der Bereichstabelle \[sn_wsd_core_area\]. |
| Ergebnis.reservierbare Einheiten | Details zu den reservierbaren Einheiten, die den angegebenen Suchkriterien entsprechen. Eine reservierbare Einheit ist ein einzelnes reservierbares Element, z. B. ein Schreibtisch oder ein Stuhl. Datentyp: Array von Objekten "reservableUnits": [ { "area": "String", "availableTimes": [Array], "building": {Object}, "campus": {Object}, "capacity": "String", "defaultPrivacyValue": Boolean, "description": "String", "email": "String", "external_id": "String", "floor": {Object}, "image": {Object}, "includedInResult": Boolean, "is_available": Boolean, "is_favorite": Boolean, "is_reservable": "String", "is_reserved": Boolean, "is_selected": Boolean, "location_type": {Object}, "name": "String", "number": "String", "order": "String", "require_approval": Boolean, "requires_check_in": Boolean, "reservable_quantity": "String", "showPrivacyOption": Boolean, "site": {Object}, "standard_services": [Array], "tableName": "String", "title": "String", "reservable_purposes": [Array], "reservations": [Array], "sys_id": "String" } ] |
| Ergebnis.reservierbarEinheiten.Bereich | Details zum Bereich, in dem sich das reservierbare Modul befindet. Datentyp: Objekt "area": { "display_value": "String", "sys_id": "String" } Tabelle: Bereich \[sn_wsd_core_area\] |
| Ergebnis.reservierbare Einheiten.Bereich.Display_Wert | Anzeigewert für den reservierbaren Modulbereich. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Bereich.sys_ID | SYS_ID des Bereichsdatensatzes, der dem reservierbaren Element zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.VerfügbarZeiten | Liste der Daten/Uhrzeiten, zu denen das zugehörige reservierbare Element verfügbar ist. Datentyp: Array |
| Ergebnis.reservierbarEinheiten.Gebäude | Details zum Gebäude, in dem sich das reservierbare Element befindet. Datentyp: Objekt "building": { "display_value": "String", "sys_id": "String" } Tabelle: Gebäude \[sn_wsd_core_building\] |
| Ergebnis.reservierbare Einheiten.Gebäude.Display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Gebäude.sys_ID | SYS_ID des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.reservableUnits.campus | Details zum Campus, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "campus": { "display_value": "String", "sys_id": "String" } Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableUnits.campus.display_value | Anzeigenummer des Campus, auf dem sich das reservierbare Element befindet, z. B. East Bay. Datentyp: Zeichenfolge |
| result.reservableUnits.campus.sys_id | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Campus \[sn_wsd_core_campus\] |
| result.reservableUnits.capacity | Maximale Anzahl von Personen für das reservierbare Element. Datentyp: Zahl |
| result.reservableUnits.description | Kurze Beschreibung des reservierbaren Elements. Datentyp: Zeichenfolge |
| result.reservableUnits.email | E-Mail-Adresse für das reservierbare Element. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.external_ID | Externe ID des reservierbaren Elements, das zum Synchronisieren eines in CMS zugeordneten Bereichs verwendet wird. Dieser Wert wird nur ausgefüllt, wenn diesem Standort eine Karte zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Stockwerk | Details zum Stockwerk, auf dem sich das reservierbare Element befindet. Datentyp: Objekt "floor": { "display_value": "String", "sys_id": "String" } Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbare Einheiten.Stockwerk.Display_value | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Stockwerk.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Stockwerk \[sn_wsd_core_floor\] |
| Ergebnis.reservierbare Einheiten.Bild | Details zu einem Bild, das das Layout für das zugehörige reservierbare Element darstellt. Datentyp: Objekt "image": { "link": "String", "sys_id": "String" } Tabelle: Images \[DB_image\] |
| result.reservableUnits.image.link | Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt. Datentyp: Zeichenfolge Tabelle: Images \[DB_image\] |
| Ergebnis.reservierbare Einheiten.Image.sys_ID | SYS_ID des zugeordneten Bilddatensatzes. Datentyp: Zeichenfolge |
| result.reservableUnits.includedInResult | Kennzeichnung, die angibt, ob das aktuelle reservierbare Element in den Rückgabeergebnissen enthalten ist. Gültige Werte: * Wahr: In den Rückgabeergebnissen enthalten. * Falsch: Nicht in den Rückgabeergebnissen enthalten. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_available | Kennzeichnung, die angibt, ob das reservierbare Element für die Reservierung verfügbar ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Nicht verfügbar für Reservierung. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_Favorite | Kennzeichnung, die angibt, ob das reservierbare Element als einer der Favoriten des zugeordneten Anwenders gekennzeichnet ist. Gültige Werte: * Wahr: Favorit. * Falsch: Kein Favorit. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_reserable | Kennzeichnung, die angibt, ob dieses reservierbare Element reserviert werden kann. Hinweis: Wenn include_unavailable_itemsAbfrageparameter ist auf „wahr" festgelegt, nicht verfügbare Standorte werden ebenfalls zurückgegeben. Wenn in diesem Fall bereits ein Standort reserviert ist, dann wird is_availableParameter ist „falsch", aber is_reservableIst „wahr". Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Nicht verfügbar für Reservierung. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_reserved | Kennzeichnung, die angibt, ob das reservierbare Element bereits reserviert ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Bereits reserviert. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.is_selected | Kennzeichnung, die angibt, ob das reservierbare Element bereits reserviert ist. Gültige Werte: * Wahr: Verfügbar für Reservierung. * Falsch: Bereits reserviert. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.location_type | Details zum Typ des Standorts des reservierbaren Elements, z. B. Arbeitsplatz/Schreibtisch, Café oder Fitnessstudio. Datentyp: Objekt "location_type": { "display_value": "String", "name": "String", "sys_id": "String" } Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservableUnits.location_type.​Display_value | Anzeigewert des Standorttyps. Datentyp: Zeichenfolge |
| result.reservableUnits.location_type.name | Name des Standorttyps, z. B. Keller oder Speicher. Identisch mit Anzeigewert. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.location_type.sys_ID | SYS_ID des zugeordneten Datensatzes. Datentyp: Zeichenfolge Tabelle: Bereichstyp \[sn_wsd_core_space_type\] |
| result.reservableUnits.name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Nummer | Eindeutiger Bezeichner des reservierbaren Elements. Dieser Wert ist visuell lesbarer als die sys_ID. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reihenfolge | Auftragsnummer für reservierbares Element. Datentyp: Zahl |
| Ergebnis.reservableUnits.require_Approval | Kennzeichnung, die angibt, ob die Reservierung des reservierbaren Elements eine Genehmigung erfordert. Mögliche Werte: * Wahr: Genehmigung erforderlich. * Falsch: Genehmigung ist nicht erforderlich. Datentyp: Boolescher Wert |
| Ergebnis.reservableUnits.requires_Check_in | Kennzeichnung, die angibt, ob für das reservierbare Element der Anwender das Einchecken erfordert. Gültige Werte: * Wahr: Einchecken erforderlich. * Falsch: Einchecken ist nicht erforderlich. Datentyp: Boolescher Wert |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke | Details zum Zweck der Reservierung des zugehörigen reservierbaren Elements. Datentyp: Array von Objekten "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| Ergebnis.reservableUnits.reservable_purposes.​Name | Name des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke.​Kurzbeschreibung | Kurze Beschreibung des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.reservierbare_Zwecke.​sys_ID | SYS_ID des reservierbaren Zweckdatensatzes. Datentyp: Zeichenfolge Tabelle: Reservierbarer Zweck \[sn_wsd_rsv_reservable_purpose\] |
| Ergebnis.reservierbarEinheiten.Reservierungen | Details zu den Reservierungen, die dem reservierbaren Element zugeordnet sind. Wird nur ausgefüllt, wenn include_reservations_within_daysAbfrageparameter ist „wahr" und „ reservation_idsParameter enthält Reservierungs-IDs, d. h. für dieses reservierbare Element sind bereits Reservierungen vorhanden. Datentyp: Array von Objekten "reservations": [ { "configuration_item": "String", "end": "String", "is_collided": Boolean, "location": {Object}, "number": "String", "requested_for": {Object}, "reservation_purpose": {Object}, "start": "String", "state": {Object}, "subject": "String", "sys_id": "String" } ] |
| Ergebnis.reservableEinheiten.Reservierungen.​Configuration_item | Konfigurationselemente, die der Reservierung entsprechen. Datentyp: Zeichenfolge Tabelle: Konfigurationselement \[cmdb_ci\] |
| Ergebnis.reservierbarEinheiten.Reservierungen.Ende | Enddatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC: jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.reservableUnits.Reservierungen.is_Collided | Kennzeichnung, die angibt, ob die Reservierung mit der Start- und Endzeit der Suche kollidiert. Dies gibt an, dass der zugeordnete reservierbare Standort bereits für die angegebene Suchzeitspanne reserviert ist. Mögliche Werte: * Wahr: Kollision. * Falsch: Keine Kollision. Datentyp: Boolescher Wert |
| Ergebnis.reservierbarEinheiten.Reservierungen.Standort | Details zum Standort der Reservierung. Datentyp: Objekt "location": { "location": "String", "timezone": {Object} } |
| Ergebnis.reservierbarEinheiten.Reservierungen.Standort.​Standort | SYS_ID des zugeordneten Standortdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone | Details zur Zeitzone, die dem Standort zugeordnet ist. Datentyp: Objekt "timezone": { "displayValue": "String", "value": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone.Anzeigewert | Anzeigewert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.Standort.​Zeitzone.Wert | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Nummer | Eindeutiger Bezeichner des reservierbaren Elements. Dieser Wert ist visuell lesbarer als die sys_ID. Datentyp: Zeichenfolge |
| Ergebnis.reservableEinheiten.Reservierungen.​Angefordert_für | Details zur Person, für die die Reservierung angefordert wurde. Datentyp: Objekt "requested_for": { "name": "String", "sys_id": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.​requested_for.name | Name des Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Angefordert_für.sys_ID | SYS_ID des Anwenders, für den die Reservierung angefordert wird. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Ergebnis.reservierbare Einheiten.Reservierungen. Reservierungszweck ​ | Details zum Zweck der Reservierung. Datentyp: Objekt "reservation_purpose": { "display_value": "String", "value": "String" } |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Reservation_purpose.Display_value | Anzeigewert für den Zweck der Reservierung, z. B. Unternehmensbesprechung. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.​Reservation_purpose.value | Interner Wert für den Zweck der Reservierung, z. B. Company_Meeting. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Start | Startdatum und -Uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC -- jjjj-mm-ddThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| Ergebnis.reservierbarEinheiten.Reservierungen.Status | Details zum Status der Reservierung für den Standort. Datentyp: Objekt "state": { "display_value": "String", "value": "String" } |
| Ergebnis.reservableEinheiten.Reservierungen.Status.​Display_value | Anzeigewert für den aktuellen Status der Reservierung, z. B. bestätigt. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.Status.Wert | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| Ergebnis.reservierbarEinheiten.Reservierungen.Betreff | Betreff der Reservierung. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Reservierungen.sys_ID | Erforderlich. SYS_ID des Reservierungsdatensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzreservierung \[sn_wsd_rsv_reservation\] |
| Ergebnis.reservierbare Einheiten.reservierbare_Menge | Maximale Anzahl, mit der das zugeordnete reservierbare Element für dieselbe Zeit reserviert werden kann. Dieser Wert wird verwendet, wenn einem Bereich Arbeitsbereiche zugewiesen werden. Datentyp: Ganzzahl |
| result.reservableUnits.site | Details zum Standort, an dem sich das reservierbare Element befindet. Datentyp: Objekt "site": { "display_value": "String", "sys_id": "String" } Tabelle: Site \[sn_wsd_core_site\] |
| Ergebnis.reservierbare Einheiten.Site.Display_value | Anzeigewert der Website. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Site.sys_ID | SYS_ID des zugeordneten Site-Datensatzes. Datentyp: Zeichenfolge Tabelle: Site \[sn_wsd_core_site\] |
| Ergebnis.reservableUnits.Standard_Services | Zugehörige Standardservices, z. B. Flipchart, Projektorbildschirm, Whiteboard und Markierungen. Datentyp: Array von Objekten "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| Result.reservableUnits.Standard_Services.​Font_Awesome_icon | Name des Miniaturansichtssymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| result.reservableUnits.standard_services.name | Name des Miniaturansichtssymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.Standard_Services.​Short_description | Kurze Beschreibung des Standardservice. Datentyp: Zeichenfolge |
| Ergebnis.reservableUnits.Standard_Services.sys_ID | SYS_ID des Standardservicedatensatzes. Datentyp: Zeichenfolge Tabelle: Standardservice \[sn_wsd_rsv_standard_service\] |
| Ergebnis.reservierbare Einheiten.sys_ID | SYS_ID des reservierbaren Datensatzes. Datentyp: Zeichenfolge Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Ergebnis.reservableEinheiten.tableName | Name der Tabelle, in der sich der reservierbare Datensatz befindet. Datentyp: Zeichenfolge |
| Ergebnis.reservierbare Einheiten.Titel | Titel des reservierbaren Elements. Datentyp: Zeichenfolge |
| Ergebnis.Gesamtverarbeitete | Gesamtanzahl der verarbeiteten Datensätze. Datentyp: Zahl |
[ ]

### Curl-Anforderung {#wsd_search-GET-reservable__example_w3q_yn1_hzb}

Dieses Beispiel zeigt, wie mit diesem Endpunkt nach reservierbaren Elementen gesucht wird. Hinweis: Zeilenumbrüche wurden den Abfrageparametern hinzugefügt, um das Lesen zu erleichtern.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/reservable?
    reservable_module=d9864189c3653910977396cb05013100&
    start=2023-10-12T10:30:00Z&
    end=2023-10-13T11:30:00Z&
    include_standard_services=true&
    include_reservable_purposes=true&
    include_reservations_within_days=true&
    include_unavailable_items=true&
    near_by_location_id=undefined&
    timezone=Europe/Paris&
    page_size=6&
    sort_by=a_z&
    view=schedule&
    rsv_path=browse_all&
    ignore_same_day_validation=true&
    schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
    q=building=dea39b1977220110b3d7be377b5a9955\
    --request GET \
    --header "Accept:application/json" 
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": {
        "hasMore": true,
        "reservableUnits": [
          {
            "sys_id": "fe1f744edb7650106c731dcd139619ca",
            "external_id": null,
            "email": null,
            "name": "Aspen",
            "title": "Aspen",
            "description": "A room with large windows, dark leather seats and a large wooden table.",
            "image": {
              "sys_id": "41c74902dbb650106c731dcd13961944",
              "link": "41c74902dbb650106c731dcd13961944.iix"
            },
            "number": "ROOM0000903",
            "site": {
              "sys_id": "628eec06db7650106c731dcd139619dd",
              "display_value": "North America"
            },
            "campus": {
              "sys_id": "82b2a0cedb3650106c731dcd139619e9",
              "display_value": "California Campus"
            },
            "building": {
              "sys_id": "94e264cedb3650106c731dcd13961919",
              "display_value": "CAL-B1"
            },
            "floor": {
              "sys_id": "2f554296dbba10106c731dcd139619ed",
              "display_value": "Floor 2"
            },
            "area": null,
            "capacity": "16",
            "reservable_quantity": null,
            "location_type": {
              "sys_id": "20713b83eb512010b89bfdfc9c522899",
              "display_value": "Room",
              "name": "Room"
            },
            "order": null,
            "requires_check_in": null,
            "is_reservable": "1",
            "tableName": "sn_wsd_core_room",
            "require_approval": false,
            "standard_services": [
              {
                "sys_id": "9b01458edb7650106c731dcd13961945",
                "name": "Flip chart",
                "short_description": "Flip chart with paper sheets",
                "font_awesome_icon": "fa-calendar-o"
              }
            ],
            "reservable_purposes": [
              {
                "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
                "name": "Board room",
                "short_description": null
              }
            ],
            "is_available": true,
            "reservations": [
              {
                "sys_id": "5fe65830874bc9106342b846dabb352b",
                "number": "WRES0001001",
                "location": {
                  "location": "fe1f744edb7650106c731dcd139619ca",
                  "timezone": {
                    "value": "US/Pacific",
                    "displayValue": "US/Pacific"
                  }
                },
                "configuration_item": null,
                "start": "2022-04-23T08:30:00Z",
                "end": "2022-04-23T09:30:00Z",
                "subject": null,
                "reservation_purpose": {
                  "value": "meeting",
                  "display_value": "Meeting"
                },
                "state": {
                  "value": "confirmed",
                  "display_value": "Confirmed"
                },
                "is_collided": false,
                "requested_for": {
                  "sys_id": "2de07e1887cb89106342b846dabb35fe",
                  "name": "Workplace User"
                }
              }
            ],
            "availableTimes": [
              [
                "2022-04-23 07:00:00",
                "2022-04-23 08:30:00"
              ],
              [
                "2022-04-23 09:30:00",
                "2022-04-23 23:00:00"
              ]
            ],
           "is_reserved": true,
           "is_selected": true,
            "includedInResult": true,
            "is_favorite": false
          }
        ],
        "reservableContainers": [],
        "nextItemIndex": -1,
        "filter": {
          "floors": [],
          "standard_services": [
            {
              "sys_id": "9b01458edb7650106c731dcd13961945",
              "name": "Flip chart",
              "short_description": "Flip chart with paper sheets",
              "font_awesome_icon": "fa-calendar-o"
            }
          ],
          "reservable_purposes": [
            {
              "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
              "name": "Board room",
              "short_description": null
            }
          ]
        },
        "totalProcessed": 2,
        "nextFavIndex": 0
      }
    }

## WSD-Suche -- RUFT /api/sn_wsd_rsv/search/Shift/{Building_ID}/{Module_ID} AB {#ariaid-title6}

Gibt eine codierte Abfrage zurück, mit der Sie in der Tabelle „Schicht \[sn_wsd_core_shift\]" nach verfügbaren Schichten suchen können.
Gilt nur, wenn das Feld „appy_to_Shift" im angegebenen reservierbaren Modul aktiviert ist. Andernfalls ist die zurückgegebene codierte Abfragezeichenfolge leer.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/Shift/{Building_ID}/{Module_ID}

Standard-URL: /api/sn_wsd_rsv/search/Shift/{Building_ID}/{Module_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_search-GET-shift__entry__2}{#wsd_search-GET-shift__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 |
| Gebäude_ID | SYS_ID des Gebäudes, das in die Suchabfrage aufgenommen werden soll. Datentyp: Zeichenfolge Tabelle: Gebäude \[sn_wsd_core_building\] |
| module_id | SYS_ID des reservierbaren Moduls, das in die Suchabfrage aufgenommen werden soll. Ein reservierbares Modul gruppiert ähnliche Arten von Arbeitsplatzelementen, z. B. Stühle oder Schreibtische. Datentyp: Zeichenfolge Tabelle: Reservierbares Modul \[sn_wsd_core_reservable_module\] |
[Tabelle : 25. Pfad-Parameter]

{#wsd_search-GET-shift__entry__10}

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

{#wsd_search-GET-shift__entry__14}

| Name | Beschreibung |
|-|-|
| end_date | Enddatum und -Uhrzeit der Schicht, die in die codierte Abfrage aufgenommen werden sollen. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| start_date | Startdatum und -Uhrzeit der Schicht, die in die codierte Abfrage aufgenommen werden sollen. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
[Tabelle : 27. 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_search-GET-shift__entry__20}{#wsd_search-GET-shift__accept-reserv-entry}

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

{#wsd_search-GET-shift__entry__24}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. 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_search-GET-shift__entry__28}{#wsd_search-GET-shift__entry-200-status-code}{#wsd_search-GET-shift__entry-401-status-code}{#wsd_search-GET-shift__entry-404-status-code}{#wsd_search-GET-shift__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 : 30. Statuscodes]

### Antworttext-Parameter

{#wsd_search-GET-shift__entry__38}

| Name | Beschreibung |
|-|-|
| Ergebnis | Codierte Abfrage, die zum Abrufen der angegebenen verfügbaren Schichten verwendet werden soll. Datentyp: Objekt "result": { "moduleHasShift": Boolean, "query": "String" } |
| ModuleHasShift | Kennzeichnung, die angibt, ob für das angegebene reservierbare Modul Schichten aktiviert sind. Gültige Werte: * Wahr: Für das reservierbare Modul sind Schichten aktiviert. * Falsch: Für das reservierbare Modul sind keine Schichten aktiviert. Keine codierte Abfrage zurückgegeben. Datentyp: Boolescher Wert |
| query | Codierte Abfrage, die zum Abrufen von Schichtinformationen für das angegebene reservierbare Modul verwendet werden soll. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt zum Abrufen einer schichtcodierten Abfrage verwendet wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/shift/94e264cedb3650106c731dcd13961919/fc71f64fdb42a01097acc900399619a8?start_date=2022-04-23 16:00:00&end_date=2022-04-28 16:00:00"  \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": { 
        "moduleHasShift" : true,
        "query" : "active=true^state=2^building=94e264cedb3650106c731dcd13961919^building.is_reservable=true^building.active=true^floorISEMPTY^ORfloor.is_reservable=true^floorISEMPTY^ORfloor.active=true^start<=2022-04-26 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY^start<=2022-04-28 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY"
      }
    }

## WSD-Suche: /api/sn_wsd_rsv/search/Availability_Score VERÖFFENTLICHEN {#ariaid-title7}

Gibt eine Verfügbarkeitspunktzahl für reservierbare Elemente für angegebene Zeitfenster zurück.

### URL-Format

Versionierte URL: /api/sn_wsd_rsv/{api_Version}/search/Availability_Score

Standard-URL: /api/sn_wsd_rsv/search/availability_Score  
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_search-POST-avail_score__entry__2}{#wsd_search-POST-avail_score__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 : 31. Pfad-Parameter]

{#wsd_search-POST-avail_score__entry__6}

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

{#wsd_search-POST-avail_score__entry__10}

| Name | Beschreibung |
|-|-|
| Wiederkehrendes Muster | Erforderlich, wenn startEndDateTimesParameter ist nicht angegeben. Wiederkehrendes Muster, das zum Suchen nach reservierbaren Elementen verwendet werden soll, die für die angegebenen wiederkehrenden Ereignisse verfügbar sind. Datentyp: Objekt "recurringPattern": { "duration": Number, "label": "String", "options": {Object}, "repeats": "String", "startDate": "String" } |
| RecurringPattern.duration | Erforderlich. Dauer, für die das reservierbare Element verfügbar sein muss. Datentyp: Zahl Einheit: Millisekunden |
| RecurringPattern.label | Beschreibung des wiederkehrenden Musters, z. B. <kbd class="ph userinput">Wird täglich 5 Mal wiederholt </kbd>. Datentyp: Zeichenfolge |
| RecurringPattern.options | Verfügbarkeitsoptionen für die wiederkehrende Reservierung, nach der gesucht werden soll. Datentyp: Objekt "options": { "count": Number, "daysOfWeek": "String", "endDate": "String", "every": Number } |
| RecurringPattern.options.count | Erforderlich, wenn endDateWurde nicht übergeben. Wenn beide bestanden werden, countWird verwendet. Anzahl der Wiederholungen des Besprechungsmusters. Datentyp: Zahl |
| RecurringPattern.options.daysOfWeek | Erforderlich, wenn recurringPattern.repeatsParameter ist auf festgelegt <kbd class="ph userinput">Wöchentlich </kbd>. Wochentage, an denen das reservierbare Element benötigt wird. Gültige Werte: * 1 = Montag * 2 = Dienstag * 3 = Mittwoch * 4 = Donnerstag * 5 = Freitag * 6 = Samstag * 7 = Sonntag Um beispielsweise Dienstag, Donnerstag und Freitag anzugeben, übergeben Sie 245 (kein Trennzeichen). Wenn repeatIst wöchentlich, countIst 5, und daysOfWeekIst 245, dann ist die Summe in den Rückgabeergebnissen gleich `Count*daysOfWeek.length `(5\*3=15). Datentyp: Zeichenfolge |
| RecurringPattern.options.endDate | Erforderlich, wenn recurringPattern.options.countWurde nicht übergeben. Wenn beide bestanden werden, countWird verwendet. Enddatum und -Uhrzeit der Wiederholung der Besprechung, z. B. „2022-07-08T14:00:00Z". Datentyp: Zeichenfolge Format: UTC JJJJ-mm-TT hh:mm:ss |
| Wiederkehrendes Muster.Optionen.alle | Musterwiederholungsintervall. Beispiel: Wenn dieser Wert ist <kbd class="ph userinput">2 </kbd>, Wiederholen Sie das Muster alternativ basierend auf der Auswahl in repeatsParameter, z. B. „jeder zweite Tag" oder „jede zweite Woche". Datentyp: Zahl |
| Wiederkehrendes Muster.Wiederholungen | Erforderlich. Wiederkehrendes Muster für das reservierbare Element. Gültige Werte (Groß-/Kleinschreibung beachten): * täglich * monatlich * wöchentlich * jährlich Datentyp: Zeichenfolge |
| RecurringPattern.startDate | Erforderlich. Startdatum und -Uhrzeit für das wiederkehrende Muster, z. B. „2022-07-08T14:00:00Z". Datentyp: Zeichenfolge Format: UTC JJJJ-mm-TT hh:mm:ss |
| Reservierbare IDs | Erforderlich. Liste der sys_IDs der reservierbaren Elemente, die in die Verfügbarkeitspunktzahl aufgenommen werden sollen. Datentyp: Array Tabelle: Arbeitsplatzstandort \[sn_wsd_core_workplace_location\] |
| Reservierbarer Typ | Erforderlich. Typ des reservierbaren Elements, das in die Verfügbarkeitspunktzahl aufgenommen werden soll. Wird verwendet, um die Suche zu verfeinern. Gültige Werte (Groß-/Kleinschreibung beachten): * configuration_item * location Datentyp: Zeichenfolge |
| StartEndDateTimes | Liste der Start- und Enddaten und -Uhrzeiten in der Zeitzone des Anwenders, nach der gesucht werden soll. Datentyp: Array von Objekten "startEndDateTimes": [ { "end": "String", "start": "String" } ] Standard: Muss angegeben werden recurringPatternParameter. |
| StartEndDateTimes.end | Enddatum und -Uhrzeit des reservierbaren Elements. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
| StartEndDateTimes.Start | Startdatum und -Uhrzeit des reservierbaren Elements. Datentyp: Zeichenfolge Format: jjjj-mm-tt hh:mm:ss |
[Tabelle : 33. 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_search-POST-avail_score__entry__42}{#wsd_search-POST-avail_score__accept-RESTAPI}{#wsd_search-POST-avail_score__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 34. Anforderungskopfzeilen.]

{#wsd_search-POST-avail_score__entry__48}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 35. 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_search-POST-avail_score__entry__52}{#wsd_search-POST-avail_score__entry-200-status-code}{#wsd_search-POST-avail_score__entry-401-status-code}{#wsd_search-POST-avail_score__entry-404-status-code}{#wsd_search-POST-avail_score__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 : 36. Statuscodes]

### Antworttext-Parameter

{#wsd_search-POST-avail_score__entry__62}

| Name | Beschreibung |
|-|-|
| Ergebnis | Gibt Ergebnisse für die angegebene Verfügbarkeitspunktzahl zurück. Datentyp: Objekt "result": { "reservable_sys_id": {Object} } |
| Ergebnis.reservierbar_sys_ID | Details zur Verfügbarkeitspunktzahl. Datentyp: Objekt "reservable_sys_id": { "available": Number, "score": "String", "total": Number } |
| Ergebnis.reservierbar_sys_ID.verfügbar | Anzahl der verfügbaren reservierbaren Elemente, die die angegebenen Suchkriterien erfüllen. Datentyp: Zahl |
| Ergebnis.reservierbar_sys_id.Punktzahl | Verfügbarkeitspunktzahl Anzahl der verfügbaren reservierbaren Elemente über die Gesamtzahl der reservierbaren Elemente, die die angegebenen Suchkriterien erfüllen. Beispiel: Wenn availableIst 2 und totalIst 4, scoreWert ist 2/4. Datentyp: Zeichenfolge |
| result.reservable_sys_id.total | Gesamtanzahl der reservierbaren Elemente, die die angegebenen Suchkriterien erfüllen. Datentyp: Zahl |
[ ]

### Curl-Anforderung

Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability_score" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"reservableType\": \"location\",
      \"reservableIds\": [
        \"fe1f744edb7650106c731dcd139619ca\",
        \"5eafb44edb7650106c731dcd13961943\"
      ],
      \"recurringPattern\": {
        \"duration\": 3600000,
        \"repeats\": \"daily\",
        \"options\": {
          \"count\": 150,
          \"daysOfWeek\": \"\",
          \"every\": 1
        },
        \"label\": \"Repeats daily, 5 times\",
        \"startDate\": \"2022-04-26T14:00:00Z\"
      },
      \"startEndDateTimes\": [
        {
          \"start\": \"2022-07-05 14:00:00\",
          \"end\": \"2022-07-05 15:00:00\"
        },
        {
          \"start\": \"2022-07-06 14:00:00\",
          \"end\": \"2022-07-06 15:00:00\"
        }
      ]
    }" \
    --user "username":"password"

Ergebnisse zurückgeben:

    {
      "result": {
        "fe1f744edb7650106c731dcd139619ca": {
          "available": 2,
          "total": 2,
          "score": "2/2"
        },
        "5eafb44edb7650106c731dcd13961943": {
          "available": 2,
          "total": 2,
          "score": "2/2"
        }
      }


