---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# WSD 검색 API

# WSD 검색 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 111분

워크플레이스 서비스 제공 (WSD) 검색 API는 예약 가능, 예약 가능한 모듈, 사용 가능한 교대조와 같은 사용 가능한 위치와 직장 항목을 검색할 수 있는 엔드포인트를 제공합니다.
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 안전 관리(sn_wsd_core) 및 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.

이 API는 `sn_wsd_rsv` 네임스페이스에서 실행됩니다.

에 대한 워크플레이스 예약 관리자세한 내용은 [워크플레이스 예약 관리를](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오.

## WSD 검색 - GET /api/sn_wsd_rsv/search/availability {#ariaid-title2}

지정된 예약 가능 항목을 지정된 시간에 사용할 수 있는지 확인합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/availability

기본 URL: /api/sn_wsd_rsv/search/availability  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-GET-availability__entry__2}{#wsd_search-GET-availability__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 1. 경로 매개변수]

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

| 이름 | 설명 |
|-|-|
| 끝 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| include_reservations_within_days | 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 사용 가능한 슬롯을 모두 반환합니다. * false: 사용 가능한 슬롯을 모두 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| reservable_ids | 필수 가용성을 평가할 예약 가능한 sys_ids의 쉼표로 구분된 목록입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| reservation_ids | 기존 예약 sys_ids의 쉼표로 구분된 목록입니다. 연결된 예약을 편집하려면 이 매개변수를 전달합니다. 해당 예약 가능 항목의 이러한 sys_ids에 대해 차단된 시간은 사용 가능한 것으로 처리됩니다. 데이터 유형: 문자열 기본값: 없음 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| reservable_module | 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. [예약 가능한 모듈](https://www.servicenow.com/docs/access?context=config-reservable-module&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)은 유사한 유형의 직장 항목을 그룹화합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] |
| schedule_view_obj | 반환할 일정 뷰에 대한 상세 정보입니다. 하루 이상 걸친 예약에 대해 24시간 가용성 데이터가 필요한 경우 이 객체를 전달합니다. 반환 결과에는 지정된 날짜의 사용 가능한 시간과 예약만 포함됩니다. 이 기능이 제대로 작동하려면 매개변수 ignore_same_day_validation 를 <kbd class="ph userinput">true</kbd>include_reservations_within_days로 설정해야 합니다. 데이터 유형: 객체 "schedule_view_obj": { "schedule_view_date": "String", "timezone": "String" } |
| schedule_view_obj.schedule_view_date | 예약 가용성 반환을 시작할 날짜입니다. 이 날짜는 매개변수에 schedule_view_obj.timezone 지정된 시간대에 있어야 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD |
| schedule_view_obj.timezone | 반환할 예약 가용성 데이터를 결정하는 데 사용할 건물 시간대입니다. 예: 미국/태평양 데이터 유형: 문자열 |
| Shift | 지정된 예약 가능한 모듈이 교대조를 기반으로 하는 경우 필요합니다. 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 [교대조 기반 예약 사용을](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 데이터 유형: 문자열 테이블: 교대조 \[sn_wsd_core_shift\] |
| 시작 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
[표 2. 쿼리 매개변수]

{#wsd_search-GET-availability__entry__28}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-GET-availability__entry__32}{#wsd_search-GET-availability__accept-reserv-entry}

| 머리글 | 설명 |
|-|-|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
[표 4. 요청 헤더]

{#wsd_search-GET-availability__entry__36}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수

{#wsd_search-GET-availability__entry__50}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 시간 동안 사용 가능한 모든 재할당 목록입니다. 데이터 유형: 객체 배열 "result": [ { "availableTimes": [Array], "building": {Object}, "campus": {Object}, "email": "String", "floor": {Object}, "is_available": Boolean, "name": "String", "reservations": [Array], "sys_id": "String" } ] |
| result.availableTimes | 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다. 데이터 유형: 배열 |
| 결과.구축 | 예약 가능한 건물과 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.building.display_value | 건물의 표시 값입니다. 데이터 유형: 문자열 |
| result.building.name | 건물의 이름입니다. 데이터 유형: 문자열 |
| result.building.sys_id | 관련 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.캠퍼스 | 예약 가능한 캠퍼스와 연결된 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 "campus": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.campus.display_value | 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay). 데이터 유형: 문자열 |
| result.campus.name | 캠퍼스 이름입니다. 데이터 유형: 문자열 |
| result.campus.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.email | 연결된 예약 가능한 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.층 | 예약 가능한 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.floor.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.floor.name | 예약 가능한 층의 이름입니다. 데이터 유형: 문자열 |
| result.floor.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.is_available | 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 예약할 수 없습니다. 데이터 유형: 부울 |
| result.name | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| 결과.예약 | 연결된 예약에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "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" } ] |
| result.reservations.configuration_item | 예약에 해당하는 구성 항목입니다. 데이터 유형: 문자열 테이블: 구성 항목 \[cmdb_ci\] |
| 결과.예약.종료 | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservations.is_collided | 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다. 이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다. 가능한 값: * true: 충돌. * false: 충돌이 없습니다. 데이터 유형: 부울 |
| 결과.예약.위치 | 예약 위치에 대한 상세 정보입니다. 데이터 유형: 객체 "location": { "location": "String", "timezone": {Object} } |
| result.reservations.location.location | 연결된 위치 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservations.location.timezone | 위치와 연결된 시간대에 대한 상세 정보입니다. 데이터 유형: 객체 "timezone": { "displayValue": "String", "value": "String" } |
| result.reservations.location.timezone.displayValue | 이 위치가 속한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservations.location.timezone.value | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservations.requested_for | 예약을 대신하여 요청한 사람에 대한 상세 정보입니다. 데이터 유형: 객체 "requested_for": { "name": "String", "sys_id": "String" } |
| result.reservations.requested_for.name | 예약이 요청된 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservations.requested_for.sys_id | 예약이 요청되는 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| result.reservations.reservation_purpose | 예약 목적에 대한 상세 정보입니다. 데이터 유형: 객체 "reservation_purpose": { "display_value": "String", "value": "String" } |
| result.reservations.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservations.reservation_purpose.value | 예약 목적의 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| 결과.예약.시작 | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| 결과.예약.상태 | 해당 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 "state": { "display_value": "String", "value": "String" } |
| result.reservations.state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.상태.값 | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| 결과.예약.제목 | 예약의 제목입니다. 데이터 유형: 문자열 |
| result.reservations.sys_id | 필수 예약 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
[ ]

### cURL 요청

다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다. 참고: 더 쉽게 읽을 수 있도록 쿼리 매개변수에 줄 바꿈이 추가되었습니다.

    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"

반환 결과:

    {
      "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 검색 - GET /api/sn_wsd_rsv/search/best_match {#ariaid-title3}

제공된 검색 기준에 따라 가장 적합한 예약 가능한 항목 일치를 검색합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/best_match

기본 URL: /api/sn_wsd_rsv/search/best_match  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-GET-best_match__entry__2}{#wsd_search-GET-best_match__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

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

| 이름 | 설명 |
|-|-|
| best_match_count | 반환할 가장 일치하는 예약 가능 항목의 수입니다. 데이터 유형: 숫자 기본값: 1 |
| 끝 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| include_reservable_purposes | 반환 결과에서 예약 가능한 각 직장 위치를 예약하는 목적을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약 가능한 목적을 반환합니다. * false: 예약 가능한 용도를 반환하지 않습니다. 데이터 유형: 부울 기본값: false 테이블: 예약 가능한 목적 \[sn_wsd_rsv_reservable_purpose\] |
| include_reservations_within_days | 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 사용 가능한 슬롯을 모두 반환합니다. * false: 사용 가능한 슬롯을 모두 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| include_standard_services | 응답에 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다. 이 정보는 표준 서비스 \[sn_wsd_rsv_standard_service\] 테이블에 있습니다. 표준 서비스는 화이트 보드, 추가 모니터 및 유사한 서비스와 같이 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 [표준 서비스를](https://www.servicenow.com/docs/access?context=standard-service&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 유효한 값은 다음과 같습니다. * true: 표준 서비스 정보를 반환합니다. * false: 표준 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| q | 필수 검색 반환 결과를 필터링하는 데 사용할 인코딩된 쿼리입니다. 이 쿼리 내에서 건물 sys_id를 지정해야 하며 층, 면적, 용량, 표준 서비스 및 reservable_purposes과 같은 매개변수를 지정할 수 있습니다. 숫자인 용량을 제외하고 전달된 모든 매개변수는 sys_ids여야 합니다. 예: `q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81` 다음 테이블에서 이 정보를 찾을 수 있습니다. * 면적: sn_wsd_core_area * 건물: sn_wsd_core_building * 층: sn_wsd_core_floor * 예약 가능한 목적: sn_wsd_rsv_reservable_purpose * 표준 서비스: sn_wsd_rsv_standard_service 데이터 유형: 문자열 |
| reservable_module | 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. [예약 가능한 모듈](https://www.servicenow.com/docs/access?context=config-reservable-module&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)은 유사한 유형의 직장 항목을 그룹화합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] |
| 시작 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| time_slot | 가장 일치하는 예약 가능한 항목을 찾으려는 시간 슬롯 기록의 Sys_id입니다. 데이터 유형: 문자열 기본값: 없음 테이블: 시간 슬롯 \[sn_wsd_rsv_time_slot\] |
| 시간대 | 기본 시간대(예: 유럽/암스테르담)입니다. 데이터 유형: 문자열 기본값: 없음 |
[표 8. 쿼리 매개변수]

{#wsd_search-GET-best_match__entry__28}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 9. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-GET-best_match__entry__32}{#wsd_search-GET-best_match__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#wsd_search-GET-best_match__entry__36}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수

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

| 이름 | 설명 |
|-|-|
| 결과 | 가장 예약 가능한 일치 항목에 대한 결과를 반환합니다. 데이터 유형: 객체 "result": { "floorsOfSelectedBuilding": [Array], "hasMore": Boolean, "nextItemIndex": Number, "reservableContainers": [Array], "reservableUnits": [Array] } |
| result.floorsOfSelectedBuilding | 예약 가능한 층에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "floorsOfSelectedBuilding": [ { "display_value": "String", "external_id": "String", "name": "String", "sys_id": "String" } ] |
| result.floorsOfSelectedBuilding.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.floorsOfSelectedBuilding.external_id | 층의 외부 식별자입니다. 데이터 유형: 문자열 |
| result.floorsOfSelectedBuilding.name | 예약 가능한 층의 이름입니다. 데이터 유형: 문자열 |
| result.floorsOfSelectedBuilding.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| 결과.has더 | 반환 결과에 예약 가능한 항목이 더 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 더 많은 예약 가능 항목 사용 가능 * false: 더 이상 사용할 수 있는 예약 가능 항목이 없습니다. 데이터 유형: 부울 |
| result.nextItemIndex | 가져올 다음으로 예약 가능한 기록의 인덱스입니다. 예약 가능한 기록을 통해 페이지를 매김할 때 이 값을 사용합니다. 데이터 유형: 숫자 |
| result.reservableContainers | selection_type 필드가 <kbd class="ph userinput">컨테이너</kbd>로 설정된 예약 가능한 모듈에 대해서만 반환됩니다. 컨테이너는 책상 그룹과 같은 유사한 항목을 그룹화한 것입니다. 데이터 유형: 객체 배열 "reservableContainers": [ { "building": {Object}, "campus": {Object}, "capacity": Number, "display_value": "String", "floor": {Object}, "image": {Object} "sys_id": "String" } ] |
| result.reservableContainers.building | 예약 가능한 컨테이너와 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.reservableContainers.building.display_value | 건물의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableContainers.building.name | 건물의 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.building.sys_id | 관련 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableContainers.campus | 예약 가능한 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 "campus": { "display_value": "String", "name": "String", "sys_id": "String" } 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableContainers.campus.display_value | 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay). 데이터 유형: 문자열 |
| result.reservableContainers.campus.name | 캠퍼스 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.campus.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableContainers.capacity | 예약 가능한 최대 수용 인원입니다. 데이터 유형: 숫자 |
| result.reservableContainers.display_value | 예약 가능한 컨테이너의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableContainers.floor | 예약 가능한 컨테이너와 연결된 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.reservableContainers.floor.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.reservableContainers.floor.name | 예약 가능한 층의 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.floor.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableContainers.image | 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다. 데이터 유형: 객체 "image": { "link": "String", "sys_id": "String" } 테이블: 이미지 \[db_image\] |
| result.reservableContainers.image.link | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다. 데이터 유형: 문자열 테이블: 이미지 \[db_image\] |
| result.reservableContainers.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableContainers.sys_id | 연결된 컨테이너 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 이 테이블이 있는 테이블은 모든 컨테이너 유형에 대해 구성할 수 있습니다. 기본적으로 영역 \[sn_wsd_core_area\] 테이블에 있습니다. |
| result.reservableUnits | 지정된 검색 기준과 일치하는 예약 가능한 단위에 대한 상세 정보입니다. 예약 가능한 단위는 책상 또는 의자와 같은 예약 가능한 단일 항목입니다. 데이터 유형: 객체 배열 "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" } ] |
| result.reservableUnits.area | 예약 가능한 모듈이 있는 영역에 대한 상세 정보입니다. 데이터 유형: 객체 "area": { "display_value": "String", "sys_id": "String" } 테이블: 영역 \[sn_wsd_core_area\] |
| result.reservableUnits.area.display_value | 예약 가능한 모듈 영역의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.area.sys_id | 예약 가능한 항목과 연결된 영역 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableUnits.availableTimes | 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다. 데이터 유형: 배열 |
| result.reservableUnits.building | 예약 가능한 건물에 대한 상세 정보입니다. 데이터 유형: 객체 "building": { "display_value": "String", "sys_id": "String" } 테이블: 건물 \[sn_wsd_core_building\] |
| result.reservableUnits.building.display_value | 건물의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.building.sys_id | 관련 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.예약 가능한 단위.캠퍼스 | 예약 가능한 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 "campus": { "display_value": "String", "sys_id": "String" } 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableUnits.campus.display_value | 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay). 데이터 유형: 문자열 |
| result.reservableUnits.campus.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableUnits.capacity | 예약 가능한 최대 수용 인원입니다. 데이터 유형: 숫자 |
| result.reservableUnits.defaultPrivacyValue | 예약 가능한 항목의 기본 개인정보 설정을 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 [위치 개인 정보 보호 설정 및 영향을](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하세요. 가능한 값: * true: 예약 가능한 항목의 개인정보 설정을 재정의할 수 있습니다. * false: 예약 가능한 항목의 개인정보 설정을 재정의할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.description | 예약 가능한 항목에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.email | 예약 가능한 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservableUnits.external_id | CMS에 매핑된 공간을 동기화하는 데 사용되는 예약 가능 항목의 외부 ID입니다. 이 값은 이 위치와 연결된 맵이 있는 경우에만 채워집니다. 데이터 유형: 문자열 |
| 결과.예약 가능한 단위.바닥 | 예약 가능한 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floor": { "display_value": "String", "sys_id": "String" } 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableUnits.floor.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.reservableUnits.floor.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableUnits.image | 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다. 데이터 유형: 객체 "image": { "link": "String", "sys_id": "String" } 테이블: 이미지 \[db_image\] |
| result.reservableUnits.image.link | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다. 데이터 유형: 문자열 테이블: 이미지 \[db_image\] |
| result.reservableUnits.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableUnits.includedInResult | 현재 예약 가능 항목이 반환 결과에 포함되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 반환 결과에 포함됩니다. * false: 반환 결과에 포함되지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_available | 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 예약할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_favorite | 예약 가능한 항목에 연결된 사용자의 즐겨찾기 중 하나로 플래그가 지정되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 즐겨찾기. * false: 즐겨찾기가 아닙니다. 데이터 유형: 부울 |
| result.reservableUnits.is_reservable | 이 예약 가능을 예약할 수 있는지 여부를 나타내는 플래그입니다. 주: 쿼리 매개변수가 include_unavailable_items true로 설정되면 사용할 수 없는 위치도 반환됩니다. 이 경우 위치가 이미 예약되어 있으면 매개변수는 is_available false is_reservable 이지만 true입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 예약할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_reserved | 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 이미 예약되어 있습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_selected | 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 이미 예약되어 있습니다. 데이터 유형: 부울 |
| result.reservableUnits.location_type | 직장/책상, 카페 또는 체육관과 같은 예약 가능한 위치 유형에 대한 상세 정보입니다. 데이터 유형: 객체 "location_type": { "display_value": "String", "name": "String", "sys_id": "String" } 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.location_type.display_value | 위치 유형의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.location_type.name | 지하실, 창고와 같은 위치 유형의 이름입니다. 표시 값과 동일합니다. 데이터 유형: 문자열 |
| result.reservableUnits.location_type.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 공간 유형 \[sn_wsd_core_space_type\] |
| result.reservableUnits.name | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.number | 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다. 데이터 유형: 문자열 |
| result.reservableUnits.order | 예약 가능한 주문 번호입니다. 데이터 유형: 숫자 |
| result.reservableUnits.require_approval | 예약 가능한 항목을 예약하려면 승인이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 승인이 필요합니다. * false: 승인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.requires_check_in | 예약 가능 항목에 사용자에게 체크인이 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 체크인이 필요합니다. * false: 체크인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.reservable_purposes | 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.reservableUnits.reservable_purposes.이름 | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservable_purposes.short_description | 예약 가능한 항목에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservable_purposes.sys_id | 예약 가능한 목적 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 가능한 목적 \[sn_wsd_rsv_reservable_purpose\] |
| 결과.예약 가능한 단위.예약 | 예약 가능한 예약과 관련된 예약에 대한 상세 정보입니다. 쿼리 매개변수가 예이고 매개변수에 reservation_ids 예약 ID가 포함되어 있는 경우에만 include_reservations_within_days 채워집니다. 이는 이 예약 가능 항목에 대한 예약이 이미 있음을 의미합니다. 데이터 유형: 객체 배열 "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" } ] |
| result.reservableUnits.reservations.configuration_item | 예약에 해당하는 구성 항목입니다. 데이터 유형: 문자열 테이블: 구성 항목 \[cmdb_ci\] |
| result.reservableUnits.reservations.end | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservableUnits.reservations.is_collided | 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다. 이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다. 가능한 값: * true: 충돌. * false: 충돌이 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.reservations.location | 예약 위치에 대한 상세 정보입니다. 데이터 유형: 객체 "location": { "location": "String", "timezone": {Object} } |
| result.reservableUnits.reservations.location.location | 연결된 위치 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.reservations.location.timezone | 위치와 연결된 시간대에 대한 상세 정보입니다. 데이터 유형: 객체 "timezone": { "displayValue": "String", "value": "String" } |
| result.reservableUnits.reservations.location.timezone.displayValue | 이 위치가 속한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.location.timezone.value | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.number | 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.requested_for | 예약을 대신하여 요청한 사람에 대한 상세 정보입니다. 데이터 유형: 객체 "requested_for": { "name": "String", "sys_id": "String" } |
| result.reservableUnits.reservations.requested_for.name | 예약이 요청된 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.requested_for.sys_id | 예약이 요청되는 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| result.reservableUnits.reservations.reservation_purpose | 예약 목적에 대한 상세 정보입니다. 데이터 유형: 객체 "reservation_purpose": { "display_value": "String", "value": "String" } |
| result.reservableUnits.reservations.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.reservation_purpose.값 | 예약 목적의 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| result.reservableUnits.reservations.start | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservableUnits.reservations.state | 해당 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 "state": { "display_value": "String", "value": "String" } |
| result.reservableUnits.reservations.state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.state.value | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| result.reservableUnits.reservations.subject | 예약의 제목입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.sys_id | 필수 예약 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| result.reservableUnits.reservable_quantity | 연결된 예약 가능 항목을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 지역에 인접 공간을 할당할 때 사용됩니다. 데이터 유형: 정수 |
| result.reservableUnits.showPrivacyOption | 직원이 연결된 예약 가능한 항목의 개인정보 설정을 재정의할 수 있는지 여부를 나타내는 플래그입니다. 이러한 개인 정보 설정에 대한 자세한 내용은 [위치 개인 정보 보호 설정 및 영향을](https://www.servicenow.com/docs/access?context=location-privacy-settings-and-impact&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하세요. 유효한 값은 다음과 같습니다. * true: 개인정보 설정을 재정의할 수 있습니다. * false: 개인정보 설정을 재정의할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.site | 예약 가능한 항목이 있는 사이트에 대한 상세 정보입니다. 데이터 유형: 객체 "site": { "display_value": "String", "sys_id": "String" } 테이블: 사이트 \[sn_wsd_core_site\] |
| result.reservableUnits.site.display_value | 사이트의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.site.sys_id | 연결된 사이트 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사이트 \[sn_wsd_core_site\] |
| result.reservableUnits.standard_services | 플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다. 데이터 유형: 객체 배열 "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.reservableUnits.standard_services.font_awesome_icon | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.name | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.short_description | 표준 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.sys_id | 표준 서비스 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 표준 서비스 \[sn_wsd_rsv_standard_service\] |
| result.reservableUnits.sys_id | 예약 가능한 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.tableName | 예약 가능한 기록이 있는 테이블의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.title | 예약 가능한 제목입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다.

    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"

반환 결과:

    {
      "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 검색 - GET /api/sn_wsd_rsv/search/overlapping_reservation {#ariaid-title4}

전달된 매개변수를 기반으로 중복된 예약이 있는지 확인합니다.
<br />

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/overlapping_reservation

기본 URL: /api/sn_wsd_rsv/search/overlapping_reservation  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-GET-overlap_resv__entry__2}{#wsd_search-GET-overlap_resv__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 13. 경로 매개변수]

{#wsd_search-GET-overlap_resv__entry__6}

| 이름 | 설명 |
|-|-|
| 끝 | 필수 중복된 예약을 확인하는 데 사용할 종료 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DDTHH:MM:SSZ |
| recurring_pattern | 예약의 반복 패턴에 대한 상세 정보입니다. 데이터 유형: 객체 "recurring_pattern": { "duration": Number, "options": {Object}, "repeats": "String", "startDate":"String" } |
| recurring_pattern.duration | 검사할 시간입니다. 데이터 유형: 숫자 단위: 초 |
| recurring_pattern.options | 반복 예약과 관련된 옵션에 대한 상세 정보입니다. 데이터 유형: 객체 "options": { "count": Number, "daysOfWeek": "String", "every": Number } |
| recurring_pattern.옵션.카운트 | 패턴이 반복되는 횟수입니다. 데이터 유형: 숫자 |
| recurring_pattern.options.daysOfWeek | 중복을 확인할 요일입니다. 유효한 값은 다음과 같습니다. * 1 = 월요일 * 2 = 화요일 * 3 = 수요일 * 4 = 목요일 * 5 = 금요일 * 6 = 토요일 * 7 = 일요일 예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. 데이터 유형: 문자열 |
| recurring_pattern.options.every | 검사할 패턴 반복 간격입니다. 예를 들어 이 값이 <kbd class="ph userinput">2</kbd>이면 격일 또는 격주와 같이 매개변수의 repeats 선택에 따라 반복 패턴을 확인합니다. 데이터 유형: 숫자 |
| recurring_pattern.options.repeats | 예약 중복 확인을 위한 반복 패턴입니다. 가능한 값: (대/소문자 구분) * 매일 * 월별 * 주별 * 매년 데이터 유형: 문자열 |
| reservable_id | 중복된 예약을 확인하기 위한 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] |
| reservation_id | 중복을 확인할 예약의 Sys_id입니다. 이 값은 다중/그룹 상위의 편집 플로우에 필요합니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| shift_info_object | 중복을 확인할 교대조의 상세 정보입니다. 교대조 기반 예약에 대한 자세한 내용은 [교대조 기반 예약 사용을](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 데이터 유형: 객체 "shift_info_object": { "applyToShift": Boolean, "shift": "String", "timezone": "String" } |
| shift_info_object.applyToShift | 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 교대조 기반 예약을 허용합니다. * false: 교대조 기반 예약을 허용하지 않습니다. 데이터 유형: 부울 |
| shift_info_object.shift | 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 데이터 유형: 문자열 테이블:Shift \[sn_wsd_core_shift\] |
| shift_info_object.timezone | 중복을 확인할 교대조의 시간대입니다. 데이터 유형: 문자열 |
| 시작 | 필수 중복된 예약을 확인하는 데 사용할 시작 시간입니다. 데이터 유형: 문자열 형식: YYY-MM-DDTHH:MM:SSZ |
| user_id | 필수 중복된 예약을 확인할 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
[표 14. 쿼리 매개변수]

{#wsd_search-GET-overlap_resv__entry__40}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-GET-overlap_resv__entry__44}{#wsd_search-GET-overlap_resv__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#wsd_search-GET-overlap_resv__entry__48}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#wsd_search-GET-overlap_resv__entry__64}

| 이름 | 설명 |
|-|-|
| 결과 | 중복 검사 결과에 대한 상세 정보입니다. 데이터 유형: 객체 "results": { "isOverlapped": Boolean, "reservableId": "String" } |
| results.isOverlapped | 중복된 예약이 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 중복된 예약이 있습니다. * false: 중복된 예약이 없습니다. 데이터 유형: 부울 |
| results.reservableId | 그룹 예약의 경우 중복이 발생하는 예약 가능 항목의 sys_id입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 코드 예제에서는 AND end 매개변수로 start 표시된 특정 기간 및 특정 기간에 대한 예약 중복을 확인하는 방법을 보여 줍니다.

    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'

반환 결과:

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

## WSD 검색 - GET /api/sn_wsd_rsv/search/reserved able {#ariaid-title5}

지정된 예약 가능한 모델 구성을 사용하여 사용 가능한 예약 가능한 항목을 검색합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/reservable

기본 URL: /api/sn_wsd_rsv/search/reservable  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-GET-reservable__entry__2}{#wsd_search-GET-reservable__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 19. 경로 매개변수]

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

| 이름 | 설명 |
|-|-|
| 끝 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 종료 시간입니다. 이 값은 매개변수에 start 지정된 값보다 나중이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| exclude_reservables | 검색 결과에서 제외할 하나 이상의 예약 가능 sys_ids 목록입니다. 데이터 유형: 문자열 또는 배열 테이블: 이러한 sys_ids이 위치한 테이블은 예약 가능한 모듈\[sn_wsd_rsv_reservable_module\] 테이블의 reservable_table 필드에 지정됩니다. 공간 \[sn_wsd_core_space\] 또는 회의실 \[sn_wsd_core_room\] 테이블일 수 있습니다. |
| ignore_same_day_validation | 예약 검색이 시작 및 종료 매개변수 간의 날짜 확인 변경을 무시하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 변경 날짜 확인을 무시합니다. * false: 변경 날짜 확인을 무시하지 마십시오. 데이터 유형: 부울 기본값: false |
| include_reservable_purposes | 반환 결과에서 예약 가능한 각 직장 위치를 예약하는 목적을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약 가능한 목적을 반환합니다. * false: 예약 가능한 용도를 반환하지 않습니다. 데이터 유형: 부울 기본값: false 테이블: 예약 가능한 목적 \[sn_wsd_rsv_reservable_purpose\] |
| include_reservations_within_days | 하루 종일 예약 가능한 각 항목에 대한 응답에서 사용 가능한 시간의 모든 여유 슬롯을 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 사용 가능한 슬롯을 모두 반환합니다. * false: 사용 가능한 슬롯을 모두 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| include_standard_services | 응답에 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다. 이 정보는 표준 서비스 \[sn_wsd_rsv_standard_service\] 테이블에 있습니다. 표준 서비스는 화이트 보드, 추가 모니터 및 유사한 서비스와 같이 예약 가능한 직장 항목에서 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 [표준 서비스를](https://www.servicenow.com/docs/access?context=standard-service&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 유효한 값은 다음과 같습니다. * true: 표준 서비스 정보를 반환합니다. * false: 표준 서비스 정보를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| near_by_location_id | 매개변수가 rsv_path<kbd class="ph userinput">browse_near_a_person</kbd>로 설정된 경우 필요합니다. 인코딩된 쿼리에 사용할 위치의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| 인접 | `rsv_path` 매개변수가 <kbd class="ph userinput">browse_by_neighborhood</kbd>로 설정된 경우 필요합니다. sn_wsd_spc_mgmt_neighborhood(공간 관리) 플러그인이 활성화된 경우에만 사용할 수 있습니다. 인코딩된 쿼리에 사용할 인접 기록의 Sys_id입니다. 인접 공간 예약에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=australia&pubname=australia-employee-service-management&ft:locale=en-US). 데이터 유형: 문자열 테이블: 인접 \[sn_wsd_spcmgmt_neighborhood\] |
| next_item_index | 검색할 다음 항목의 인덱스입니다. 반환 결과를 페이지 매김할 때 이 매개변수를 전달합니다. 데이터 유형: 숫자 기본값: 0 |
| page_size | 반환 결과에서 반환할 최대 기록 수입니다. 데이터 유형: 숫자 기본값: 6 |
| q | 필수 검색 반환 결과를 필터링하는 데 사용할 인코딩된 쿼리입니다. 이 쿼리 내에서 건물 sys_id를 지정해야 하며 층, 면적, 용량, 표준 서비스 및 reservable_purposes과 같은 매개변수를 지정할 수 있습니다. 숫자인 용량을 제외하고 전달된 모든 매개변수는 sys_ids여야 합니다. 예: `q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81` 다음 테이블에서 이 정보를 찾을 수 있습니다. * 면적: sn_wsd_core_area * 건물: sn_wsd_core_building * 층: sn_wsd_core_floor * 예약 가능한 목적: sn_wsd_rsv_reservable_purpose * 표준 서비스: sn_wsd_rsv_standard_service 데이터 유형: 문자열 |
| reservable_module | 필수 검색에 포함할 예약 가능한 모듈의 Sys_id입니다. [예약 가능한 모듈](https://www.servicenow.com/docs/access?context=config-reservable-module&version=australia&pubname=australia-employee-service-management&ft:locale=en-US)은 유사한 유형의 직장 항목을 그룹화합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] |
| reservation_ids | 기존 예약 sys_ids의 쉼표로 구분된 목록입니다. 연결된 예약을 편집하려면 이 매개변수를 전달합니다. 해당 예약 가능 항목의 이러한 sys_ids에 대해 차단된 시간은 사용 가능한 것으로 처리됩니다. 데이터 유형: 문자열 기본값: 없음 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| rsv_path | 검색에 적용할 예약 경로입니다. 유효한 값은 다음과 같습니다. * browse_all: 모든 예약 가능한 항목을 검색합니다. * browse_by_area: 특정 위치 근처의 예약 가능 항목을 검색합니다. 영역 식별자는 인코딩된 쿼리(매개변수)q 에 전달되어야 합니다. * browse_by_neighborhood: 매개변수에 지정된 인접 근처의 예약 가능한 항목을 검색합니다 neighborhood . * browse_near_a_person: 매개변수에 지정된 사람의 직장 위치 근처에서 예약 가능한 항목을 검색합니다 near_by_location_id . 데이터 유형: 문자열 기본값: browse_all |
| schedule_view_obj | 반환할 일정 뷰에 대한 상세 정보입니다. 하루 이상 걸친 예약에 대해 24시간 가용성 데이터가 필요한 경우 이 객체를 전달합니다. 반환 결과에는 지정된 날짜의 사용 가능한 시간과 예약만 포함됩니다. 이 기능이 제대로 작동하려면 매개변수 ignore_same_day_validation 를 <kbd class="ph userinput">true</kbd>include_reservations_within_days로 설정해야 합니다. 데이터 유형: 객체 "schedule_view_obj": { "schedule_view_date": "String", "timezone": "String" } |
| schedule_view_obj.schedule_view_date | 예약 가용성 반환을 시작할 날짜입니다. 이 날짜는 매개변수에 schedule_view_obj.timezone 지정된 시간대에 있어야 합니다. 데이터 유형: 문자열 형식: YYYY-MM-DD |
| schedule_view_obj.timezone | 반환할 예약 가용성 데이터를 결정하는 데 사용할 건물 시간대입니다. 예: 미국/태평양 데이터 유형: 문자열 |
| 시작 | 필수 사용 가능한 예약 가능한 모듈을 검색하는 데 사용할 시작 시간입니다. 이 값은 매개변수에 end 지정된 값보다 이전이어야 합니다. 데이터 유형: 문자열 형식: UTC 또는 현지 시간(yyyy-mm-dd hh:mm:ss) |
| Shift | 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 [교대조 기반 예약 사용을](https://www.servicenow.com/docs/access?context=wsd-reservation-setup&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 데이터 유형: 문자열 테이블: 교대조 \[sn_wsd_core_shift\] |
| sort_by | 반환된 예약 가능한 항목의 원하는 정렬 순서입니다. 유효한 값은 다음과 같습니다. * a_z: 오름차순 정렬 순서입니다. * favorites_first: 사용자가 가장 좋아하는 직장 예약 가능한 항목을 기준으로 먼저 정렬되고 나머지는 오름차순으로 정렬됩니다. * z_a: 내림차순 정렬 순서입니다. 데이터 유형: 문자열 기본값: a_z |
| 시간대 | 기본 시간대(예: 유럽/암스테르담)입니다. 데이터 유형: 문자열 기본값: 없음 |
[표 20. 쿼리 매개변수]

{#wsd_search-GET-reservable__entry__50}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 21. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-GET-reservable__entry__54}{#wsd_search-GET-reservable__accept-reserv-entry}

| 머리글 | 설명 |
|-|-|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
[표 22. 요청 헤더]

{#wsd_search-GET-reservable__entry__58}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 23. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

### 응답 본문 매개변수

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

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 검색에 대한 결과를 반환합니다. 데이터 유형: 객체 "result": { "filter": {Object}, "hasMore": Boolean, "nextFavIndex": Number, "nextItemIndex": Number, "reservableContainers": [Array], "reservableUnits": [Array], "totalProcessed": Number } |
| 결과.필터 | 층, 표준 서비스 및 예약 가능한 항목의 예약 가능 목적에 대한 상세 정보입니다. 또는 include_reservable_purposes 매개변수가 include_standard_services false standard_servicesreservable_purposes 로 설정되고 빈 배열인 경우. 데이터 유형: 객체 "filter": { "floors": [Array], "reservable_purposes": [Array], "standard_services": [Array] } |
| 결과.필터.층 | 예약 가능한 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floors": [ { "display_value": "String", "sys_id": "String" } ] |
| result.filter.floors.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.filter.floors.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.filter.standard_services | 매개변수가 include_standard_services true로 설정된 경우에만 채워집니다. 플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다. 데이터 유형: 객체 배열 "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.filter.standard_services.font_awesome_icon | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.filter.standard_services.name | 표준 서비스의 이름입니다. 데이터 유형: 문자열 |
| result.filter.standard_services.short_description | 표준 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.filter.standard_services.sys_id | 표준 서비스 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 표준 서비스 \[sn_wsd_rsv_standard_service\] |
| result.filter.reservable_purposes | 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.filter.reservable_purposes.name | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| result.filter.reservable_purposes.short_description | 예약 가능한 항목에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.filter.reservable_purposes.sys_id | 예약 가능한 목적 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 가능한 목적 \[sn_wsd_rsv_reservable_purpose\] |
| 결과.has더 | 반환 결과에 예약 가능한 항목이 더 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 더 많은 예약 가능 항목 사용 가능 * false: 더 이상 사용할 수 있는 예약 가능 항목이 없습니다. 데이터 유형: 부울 |
| result.nextFavIndex | 사용자가 예약할 수 있는 다음 즐겨찾기에 대한 인덱스입니다. 사용자가 즐겨찾는 예약 가능 항목을 통해 페이지를 매김할 때 이 값을 사용합니다. 데이터 유형: 숫자 |
| result.nextItemIndex | 가져올 다음으로 예약 가능한 기록의 인덱스입니다. 예약 가능한 기록을 통해 페이지를 매김할 때 이 값을 사용합니다. 데이터 유형: 숫자 |
| result.reservableContainers | selection_type 필드가 <kbd class="ph userinput">컨테이너</kbd>로 설정된 예약 가능한 모듈에 대해서만 반환됩니다. 컨테이너는 책상 그룹과 같은 유사한 항목을 그룹화한 것입니다. 데이터 유형: 객체 배열 "reservableContainers": [ { "building": {Object}, "campus": {Object}, "capacity": Number, "display_value": "String", "floor": {Object}, "image": {Object} "sys_id": "String" } ] |
| result.reservableContainers.building | 예약 가능한 컨테이너와 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 "building": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.reservableContainers.building.display_value | 건물의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableContainers.building.name | 건물의 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.building.sys_id | 관련 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableContainers.campus | 예약 가능한 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 "campus": { "display_value": "String", "name": "String", "sys_id": "String" } 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableContainers.campus.display_value | 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay). 데이터 유형: 문자열 |
| result.reservableContainers.campus.name | 캠퍼스 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.campus.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableContainers.capacity | 예약 가능한 최대 수용 인원입니다. 데이터 유형: 숫자 |
| result.reservableContainers.display_value | 예약 가능한 컨테이너의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableContainers.floor | 예약 가능한 컨테이너와 연결된 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floor": { "display_value": "String", "name": "String", "sys_id": "String" } |
| result.reservableContainers.floor.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.reservableContainers.floor.name | 예약 가능한 층의 이름입니다. 데이터 유형: 문자열 |
| result.reservableContainers.floor.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableContainers.image | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다. 데이터 유형: 문자열 테이블: 이미지 \[db_image\] |
| result.reservableContainers.image.link | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다. 데이터 유형: 문자열 테이블: 이미지 \[db_image\] |
| result.reservableContainers.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableContainers.sys_id | 연결된 컨테이너 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 이 테이블이 있는 테이블은 모든 컨테이너 유형에 대해 구성할 수 있습니다. 기본적으로 영역 \[sn_wsd_core_area\] 테이블에 있습니다. |
| result.reservableUnits | 지정된 검색 기준과 일치하는 예약 가능한 단위에 대한 상세 정보입니다. 예약 가능한 단위는 책상 또는 의자와 같은 예약 가능한 단일 항목입니다. 데이터 유형: 객체 배열 "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" } ] |
| result.reservableUnits.area | 예약 가능한 모듈이 있는 영역에 대한 상세 정보입니다. 데이터 유형: 객체 "area": { "display_value": "String", "sys_id": "String" } 테이블: 영역 \[sn_wsd_core_area\] |
| result.reservableUnits.area.display_value | 예약 가능한 모듈 영역의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.area.sys_id | 예약 가능한 항목과 연결된 영역 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableUnits.availableTimes | 연결된 예약 가능 항목을 사용할 수 있는 날짜/시간 목록입니다. 데이터 유형: 배열 |
| result.reservableUnits.building | 예약 가능한 건물에 대한 상세 정보입니다. 데이터 유형: 객체 "building": { "display_value": "String", "sys_id": "String" } 테이블: 건물 \[sn_wsd_core_building\] |
| result.reservableUnits.building.display_value | 건물의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.building.sys_id | 관련 건물 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| 결과.예약 가능한 단위.캠퍼스 | 예약 가능한 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 "campus": { "display_value": "String", "sys_id": "String" } 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableUnits.campus.display_value | 예약 가능한 항목이 위치한 캠퍼스의 번호를 표시합니다(예: East Bay). 데이터 유형: 문자열 |
| result.reservableUnits.campus.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 \[sn_wsd_core_campus\] |
| result.reservableUnits.capacity | 예약 가능한 최대 수용 인원입니다. 데이터 유형: 숫자 |
| result.reservableUnits.description | 예약 가능한 항목에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.email | 예약 가능한 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservableUnits.external_id | CMS에 매핑된 공간을 동기화하는 데 사용되는 예약 가능 항목의 외부 ID입니다. 이 값은 이 위치와 연결된 맵이 있는 경우에만 채워집니다. 데이터 유형: 문자열 |
| 결과.예약 가능한 단위.바닥 | 예약 가능한 층에 대한 상세 정보입니다. 데이터 유형: 객체 "floor": { "display_value": "String", "sys_id": "String" } 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableUnits.floor.display_value | 예약 가능한 층의 번호를 표시합니다(예: 12). 데이터 유형: 문자열 |
| result.reservableUnits.floor.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 \[sn_wsd_core_floor\] |
| result.reservableUnits.image | 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 상세 정보입니다. 데이터 유형: 객체 "image": { "link": "String", "sys_id": "String" } 테이블: 이미지 \[db_image\] |
| result.reservableUnits.image.link | 이 예약 가능한 항목의 레이아웃을 나타내는 이미지에 대한 링크입니다. 데이터 유형: 문자열 테이블: 이미지 \[db_image\] |
| result.reservableUnits.image.sys_id | 연결된 이미지 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservableUnits.includedInResult | 현재 예약 가능 항목이 반환 결과에 포함되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 반환 결과에 포함됩니다. * false: 반환 결과에 포함되지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_available | 예약 가능 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 예약할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_favorite | 예약 가능한 항목에 연결된 사용자의 즐겨찾기 중 하나로 플래그가 지정되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 즐겨찾기. * false: 즐겨찾기가 아닙니다. 데이터 유형: 부울 |
| result.reservableUnits.is_reservable | 이 예약 가능을 예약할 수 있는지 여부를 나타내는 플래그입니다. 주: 쿼리 매개변수가 include_unavailable_items true로 설정되면 사용할 수 없는 위치도 반환됩니다. 이 경우 위치가 이미 예약되어 있으면 매개변수는 is_available false is_reservable 이지만 true입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 예약할 수 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_reserved | 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 이미 예약되어 있습니다. 데이터 유형: 부울 |
| result.reservableUnits.is_selected | 예약 가능 항목이 이미 예약되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약할 수 있습니다. * false: 이미 예약되어 있습니다. 데이터 유형: 부울 |
| result.reservableUnits.location_type | 직장/책상, 카페 또는 체육관과 같은 예약 가능한 위치 유형에 대한 상세 정보입니다. 데이터 유형: 객체 "location_type": { "display_value": "String", "name": "String", "sys_id": "String" } 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.location_type.display_value | 위치 유형의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.location_type.name | 지하실, 창고와 같은 위치 유형의 이름입니다. 표시 값과 동일합니다. 데이터 유형: 문자열 |
| result.reservableUnits.location_type.sys_id | 관련 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 공간 유형 \[sn_wsd_core_space_type\] |
| result.reservableUnits.name | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.number | 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다. 데이터 유형: 문자열 |
| result.reservableUnits.order | 예약 가능한 주문 번호입니다. 데이터 유형: 숫자 |
| result.reservableUnits.require_approval | 예약 가능한 항목을 예약하려면 승인이 필요한지 여부를 나타내는 플래그입니다. 가능한 값: * true: 승인이 필요합니다. * false: 승인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.requires_check_in | 예약 가능 항목에 사용자에게 체크인이 필요한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 체크인이 필요합니다. * false: 체크인이 필요하지 않습니다. 데이터 유형: 부울 |
| result.reservableUnits.reservable_purposes | 연결된 예약 가능 항목을 예약하는 목적에 대한 상세 정보입니다. 데이터 유형: 객체 배열 "reservable_purposes": [ { "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.reservableUnits.reservable_purposes.이름 | 예약 가능한 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservable_purposes.short_description | 예약 가능한 항목에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservable_purposes.sys_id | 예약 가능한 목적 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 가능한 목적 \[sn_wsd_rsv_reservable_purpose\] |
| 결과.예약 가능한 단위.예약 | 예약 가능한 예약과 관련된 예약에 대한 상세 정보입니다. 쿼리 매개변수가 예이고 매개변수에 reservation_ids 예약 ID가 포함되어 있는 경우에만 include_reservations_within_days 채워집니다. 이는 이 예약 가능 항목에 대한 예약이 이미 있음을 의미합니다. 데이터 유형: 객체 배열 "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" } ] |
| result.reservableUnits.reservations.configuration_item | 예약에 해당하는 구성 항목입니다. 데이터 유형: 문자열 테이블: 구성 항목 \[cmdb_ci\] |
| result.reservableUnits.reservations.end | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservableUnits.reservations.is_collided | 예약이 검색 시작 및 종료 시간과 충돌하는지 여부를 나타내는 플래그입니다. 이는 연결된 예약 가능한 위치가 지정된 검색 시간 범위에 대해 이미 예약되어 있음을 나타냅니다. 가능한 값: * true: 충돌. * false: 충돌이 없습니다. 데이터 유형: 부울 |
| result.reservableUnits.reservations.location | 예약 위치에 대한 상세 정보입니다. 데이터 유형: 객체 "location": { "location": "String", "timezone": {Object} } |
| result.reservableUnits.reservations.location.location | 연결된 위치 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.reservations.location.timezone | 위치와 연결된 시간대에 대한 상세 정보입니다. 데이터 유형: 객체 "timezone": { "displayValue": "String", "value": "String" } |
| result.reservableUnits.reservations.location.timezone.displayValue | 이 위치가 속한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.location.timezone.value | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.number | 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 읽을 수 있습니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.requested_for | 예약을 대신하여 요청한 사람에 대한 상세 정보입니다. 데이터 유형: 객체 "requested_for": { "name": "String", "sys_id": "String" } |
| result.reservableUnits.reservations.requested_for.name | 예약이 요청된 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.requested_for.sys_id | 예약이 요청되는 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| result.reservableUnits.reservations.reservation_purpose | 예약 목적에 대한 상세 정보입니다. 데이터 유형: 객체 "reservation_purpose": { "display_value": "String", "value": "String" } |
| result.reservableUnits.reservations.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.reservation_purpose.값 | 예약 목적의 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| result.reservableUnits.reservations.start | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservableUnits.reservations.state | 해당 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 "state": { "display_value": "String", "value": "String" } |
| result.reservableUnits.reservations.state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.state.value | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| result.reservableUnits.reservations.subject | 예약의 제목입니다. 데이터 유형: 문자열 |
| result.reservableUnits.reservations.sys_id | 필수 예약 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 \[sn_wsd_rsv_reservation\] |
| result.reservableUnits.reservable_quantity | 연결된 예약 가능 항목을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 지역에 인접 공간을 할당할 때 사용됩니다. 데이터 유형: 정수 |
| result.reservableUnits.site | 예약 가능한 항목이 있는 사이트에 대한 상세 정보입니다. 데이터 유형: 객체 "site": { "display_value": "String", "sys_id": "String" } 테이블: 사이트 \[sn_wsd_core_site\] |
| result.reservableUnits.site.display_value | 사이트의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservableUnits.site.sys_id | 연결된 사이트 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사이트 \[sn_wsd_core_site\] |
| result.reservableUnits.standard_services | 플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 관련 표준 서비스입니다. 데이터 유형: 객체 배열 "standard_services": [ { "font_awesome_icon": "String", "name": "String", "short_description": "String", "sys_id": "String" } ] |
| result.reservableUnits.standard_services.font_awesome_icon | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.name | 표준 서비스와 연결된 썸네일 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.short_description | 표준 서비스에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservableUnits.standard_services.sys_id | 표준 서비스 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 표준 서비스 \[sn_wsd_rsv_standard_service\] |
| result.reservableUnits.sys_id | 예약 가능한 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| result.reservableUnits.tableName | 예약 가능한 기록이 있는 테이블의 이름입니다. 데이터 유형: 문자열 |
| result.reservableUnits.title | 예약 가능한 제목입니다. 데이터 유형: 문자열 |
| result.totalProcessed | 처리된 총 기록 수입니다. 데이터 유형: 숫자 |
[ ]

### cURL 요청 {#wsd_search-GET-reservable__example_w3q_yn1_hzb}

이 예시에서는 이 엔드포인트를 사용하여 예약 가능 항목을 검색하는 방법을 보여줍니다. 참고: 더 쉽게 읽을 수 있도록 쿼리 매개변수에 줄 바꿈이 추가되었습니다.

    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"

반환 결과:

    {
      "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 검색 - GET /api/sn_wsd_rsv/search/shift/{building_id}/{module_id} {#ariaid-title6}

교대조 \[sn_wsd_core_shift\] 테이블에서 사용 가능한 교대조를 검색하는 데 사용할 수 있는 인코딩된 쿼리를 반환합니다.
지정된 예약 가능한 모듈의 appy_to_shift 필드가 활성화된 경우에만 적용할 수 있습니다. 그렇지 않으면 반환된 인코딩된 쿼리 문자열이 비어 있습니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/shift/{building_id}/{module_id}

기본 URL: /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-GET-shift__entry__2}{#wsd_search-GET-shift__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| building_id | 검색 쿼리에 포함할 건물의 Sys_id입니다. 데이터 유형: 문자열 테이블: 건물 \[sn_wsd_core_building\] |
| module_id | 검색 쿼리에 포함할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 의자 또는 책상과 같은 유사한 유형의 직장 항목을 그룹화합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_core_reservable_module\] |
[표 25. 경로 매개변수]

{#wsd_search-GET-shift__entry__10}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 26. 쿼리 매개변수]

{#wsd_search-GET-shift__entry__14}

| 이름 | 설명 |
|-|-|
| end_date | 인코딩된 쿼리에 포함할 교대조 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| start_date | 인코딩된 쿼리에 포함할 교대조 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
[표 27. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-GET-shift__entry__20}{#wsd_search-GET-shift__accept-reserv-entry}

| 머리글 | 설명 |
|-|-|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
[표 28. 요청 헤더]

{#wsd_search-GET-shift__entry__24}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 29. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

### 응답 본문 매개변수

{#wsd_search-GET-shift__entry__38}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 사용 가능한 교대조를 획득하는 데 사용할 인코딩된 쿼리입니다. 데이터 유형: 객체 "result": { "moduleHasShift": Boolean, "query": "String" } |
| moduleHasShift | 지정된 예약 가능한 모듈에 교대조가 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 예약 가능한 모듈에 교대조가 활성화되어 있습니다. * false: 예약 가능한 모듈에 교대조가 활성화되어 있지 않습니다. 인코딩된 쿼리가 반환되지 않았습니다. 데이터 유형: 부울 |
| 쿼리 | 지정된 예약 가능한 모듈에 대한 교대조 정보를 검색하는 데 사용할 인코딩된 쿼리입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 코드 예제에서는 이 엔드포인트를 사용하여 교대조로 인코딩된 쿼리를 가져오는 방법을 보여 줍니다.

    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"

반환 결과:

    {
      "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 검색 - POST /api/sn_wsd_rsv/search/availability_score {#ariaid-title7}

지정된 시간대의 예약 가능한 항목에 대한 가용성 점수를 반환합니다.

### URL 형식

버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/search/availability_score

기본 URL: /api/sn_wsd_rsv/search/availability_score  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#wsd_search-POST-avail_score__entry__2}{#wsd_search-POST-avail_score__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 31. 경로 매개변수]

{#wsd_search-POST-avail_score__entry__6}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 32. 쿼리 매개변수]

{#wsd_search-POST-avail_score__entry__10}

| 이름 | 설명 |
|-|-|
| recurringPattern | 매개변수가 지정되지 않은 경우 startEndDateTimes 필요합니다. 지정된 반복 이벤트에 사용할 수 있는 예약 가능 항목을 검색하는 데 사용할 반복 패턴입니다. 데이터 유형: 객체 "recurringPattern": { "duration": Number, "label": "String", "options": {Object}, "repeats": "String", "startDate": "String" } |
| recurringPattern.duration | 필수 예약 가능한 항목을 사용할 수 있어야 하는 시간입니다. 데이터 유형: 숫자 단위: 밀리초 |
| recurringPattern.label | 반복 패턴에 대한 설명입니다(예: <kbd class="ph userinput">매일 5회 반복).</kbd> 데이터 유형: 문자열 |
| recurringPattern.options | 검색할 반복 예약의 가용성 옵션입니다. 데이터 유형: 객체 "options": { "count": Number, "daysOfWeek": "String", "endDate": "String" } |
| recurringPattern.options.count | 전달되지 않은 경우 endDate 필수입니다. 둘 다 전달되면 사용됩니다 count . 회의 패턴을 반복하는 횟수입니다. 데이터 유형: 숫자 |
| recurringPattern.options.daysOfWeek | 매개변수가 recurringPattern.repeats<kbd class="ph userinput">매주로</kbd> 설정된 경우 필요합니다. 예약 가능한 요일입니다. 유효한 값은 다음과 같습니다. * 1 = 월요일 * 2 = 화요일 * 3 = 수요일 * 4 = 목요일 * 5 = 금요일 * 6 = 토요일 * 7 = 일요일 예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeat is weekly이고, count 5이고, daysOfWeek 245이면 반환 결과에서 합계는 `count*daysOfWeek.length`(5\*3=15)와 같습니다. 데이터 유형: 문자열 |
| recurringPattern.options.endDate | 전달되지 않은 경우 recurringPattern.options.count 필수입니다. 둘 다 전달되면 사용됩니다 count . 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z"). 데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| recurringPattern.repeats | 필수 예약 가능한 반복 패턴입니다. 유효한 값(대/소문자 구분): * 매일 * 월별 * 주별 * 매년 데이터 유형: 문자열 |
| recurringPattern.startDate | 필수 반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z"). 데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| reservableId | 필수 가용성 점수에 포함할 예약 가능 항목 sys_ids 목록입니다. 데이터 유형: 배열 테이블: 직장 위치 \[sn_wsd_core_workplace_location\] |
| reservable유형 | 필수 가용성 점수에 포함할 예약 가능한 유형입니다. 검색을 구체화하는 데 사용됩니다. 유효한 값(대/소문자 구분): * configuration_item * 위치 데이터 유형: 문자열 |
| startEndDateTimes | 검색할 사용자의 시간대에 있는 시작 및 종료 날짜 및 시간 목록입니다. 데이터 유형: 객체 배열 "startEndDateTimes": [ { "end": "String", "start": "String" } ] 기본값: 매개변수를 지정 recurringPattern 해야 합니다. |
| startEndDateTimes.end | 예약 가능한 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
| startEndDateTimes.start | 예약 가능한 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: yyyy-mm-dd hh:mm:ss |
[표 33. 요청 본문 매개변수]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-POST-avail_score__entry__40}{#wsd_search-POST-avail_score__accept-RESTAPI}{#wsd_search-POST-avail_score__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 34. 요청 헤더]

{#wsd_search-POST-avail_score__entry__46}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 35. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wsd_search-POST-avail_score__entry__50}{#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}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 36. 상태 코드]

### 응답 본문 매개변수

{#wsd_search-POST-avail_score__entry__60}

| 이름 | 설명 |
|-|-|
| 결과 | 지정된 가용성 점수에 대한 결과를 반환합니다. 데이터 유형: 객체 "result": { "reservable_sys_id": {Object} } |
| result.reservable_sys_id | 가용성 점수에 대한 상세 정보입니다. 데이터 유형: 객체 "reservable_sys_id": { "available": Number, "score": "String", "total": Number } |
| result.reservable_sys_id.사용 가능 | 지정된 검색 기준을 충족하는 사용 가능한 예약 가능 항목 수입니다. 데이터 유형: 숫자 |
| result.reservable_sys_id.점수 | 가용성 점수 지정된 검색 기준을 충족하는 총 예약 가능 수에서 사용 가능한 예약 가능한 수입니다. 예를 들어, 가 2이고 total 4인 경우 availablescore 값은 2/4입니다. 데이터 유형: 문자열 |
| result.reservable_sys_id.total | 지정된 검색 기준을 충족하는 총 예약 가능 항목 수입니다. 데이터 유형: 숫자 |
[ ]

### cURL 요청

다음 코드 예제에서는 이 엔드포인트를 호출하는 방법을 보여 줍니다.

    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\": \"\",
        },
        \"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"

반환 결과:

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