WSD 예약 가능 항목 V2 API

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기39분

    • (WSD) 예약 가능 항목 V2 API는 Workplace Service Delivery 인스턴스에서 직장 위치와 ServiceNow 같이 예약할 수 있는 엔터티인 예약 가능 항목의 상세 정보를 검색합니다.

    WSD 예약 가능 항목 V2 API는 WSD 예약 가능한 API. WSD 예약 가능 항목 V2 API는 예약 중에 선택한 WSD 포털에서 예약 가능한 모든 공간의 상세 정보를 가져옵니다. 원래 WSD 예약 가능 API 버전은 GET 호출을 사용했지만 sys_ID 경로 매개 변수를 35자로 제한했습니다. 새 WSD 예약 가능 V2 API 버전은 POST 호출이며 문자 제한을 방지하기 위해 요청 본문의 모든 sys_ids 가져옵니다.

    이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 합니다.

    이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다. 이 API에 액세스하려면 Workplace Reservation Management(sn_wsd_rsv) 플러그인을 활성화해야 합니다.

    에 대한 Workplace Reservation Management자세한 내용은 Workplace Reservation Management를 참조하십시오.

    WSD 예약 가능 항목 V2 API - POST /sn_wsd_rsv/v2/reservable/list_reservables

    하나 이상의 지정된 예약 가능 여부에 대한 상세 정보를 반환합니다.

    URL 형식

    기본 URL: POST api/sn_wsd_rsv/v2/reservable/list_reservables

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 필수 액세스할 엔드포인트의 버전입니다. 이 API를 사용하려면 v2 를 지정하고, 그렇지 않으면 v1 을 사용하면 WSD 예약 가능 API의 기본 버전이 사용됩니다.

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    없음
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    space_sys_ids 필수 선택한 공간을 쉼표로 구분한 sys_ids입니다.

    데이터 유형: 문자열

    기본값: 빈 값

    reservable_module_sys_id

    		 필수 예약 가능한 모듈의 Sys_id(예: 책상, 회의실 등)

    예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다. 이 sys_id은 예약 가능한 모듈[sn_wsd_rsv_reservable_module] 테이블에 있습니다.

    예약 가능한 모듈에 대한 자세한 내용은 예약 가능한 모듈 구성을 참조하십시오.

    데이터 유형: 문자열

    기본값: 빈 값
    include_flexible_services 예약 가능한 서비스와 연결된 유연 서비스를 응답에 반환할지 여부를 나타내는 플래그입니다.

    유연 서비스는 예약을 할 때 예약 가능한 직장 항목과 함께 사용할 수 있는 추가 조항입니다. 예를 들어, 교실 스타일 - 모든 참가자가 회의실 앞쪽을 향하도록 배열된 테이블 행입니다. 유연 서비스에 대한 자세한 내용은 유연 서비스 만들기를 참조하세요.

    유효한 값은 다음과 같습니다.
    • true: 유연 서비스 정보를 반환합니다.
    • false: 유연 서비스 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_standard_services 응답에서 표준 서비스 정보를 반환할지 여부를 나타내는 플래그입니다.

    표준 서비스는 화이트 보드, 추가 모니터 및 유사한 서비스와 같이 예약 가능한 직장 항목과 함께 사용할 수 있는 기본 조항을 설명합니다. 표준 서비스에 대한 자세한 내용은 표준 서비스를 참조하세요. 이 정보는 표준 서비스[sn_wsd_rsv_standard_service] 테이블에 있습니다.

    유효한 값은 다음과 같습니다.
    • true: 표준 서비스 정보를 반환합니다.
    • false: 표준 서비스 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_reservable_purposes 옵션입니다. 예약 가능한 항목과 연결된 용도를 반환할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약 가능한 항목의 용도를 반환합니다.
    • false: 예약 가능한 항목의 목적을 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false
    include_layouts 응답에서 위치 레이아웃 정보를 반환할지 여부를 나타내는 플래그입니다.

    위치 레이아웃 정보에는 용량, 최대 용량, 준비 및 정리 기간 등이 포함됩니다. 이 정보는 위치 레이아웃[sn_wsd_rsv_m2m_location_layout] 테이블에 있습니다.

    유효한 값은 다음과 같습니다.
    • true: 위치 레이아웃 정보를 반환합니다.
    • false: 위치 레이아웃 정보를 반환하지 않습니다.

    데이터 유형: 부울

    기본값: false

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 4. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    콘텐츠-형식 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    404예약 가능한 항목을 찾을 수 없습니다.

    WSD 코어 공간 [sn_wsd_core_spaces] 테이블을 찾아 공간 기록이 있는지 확인합니다.
    500오류가 발생했습니다! 예약 가능한 항목을 검색할 수 없습니다.

    서버 오류입니다. 시스템 관리자에게 문의하십시오.

    응답 본문 매개변수

    이름 설명
    결과 일치하는 각 예약 가능 항목에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    {
  "result": [
    {
      "allow_invitees": Boolean,
      "area": {Object},
      "building": {Object},
      "campus": {Object},
      "capacity": Number,
      "description": "String",
      "display_number_of_attendees": Boolean,
      "display_on_behalf_of": Boolean,
      "display_sensitivity": Boolean,
      "email": "String",
      "employee_override_privacy": Boolean
      "enable_group_reservations": Boolean,
      "enable_reservation_privacy": Boolean,
      "external_id": "String",
      "flexible_services": [Array],
      "floor": {Object},
      "image": {Object},
      "is_reservable": Boolean,
      "layouts": [Array],
      "location_type": {Object},
      "meetingProviders": [Array],
      "moduleType": "String",
      "name": "String",
      "number": "String",
      "order": Number,
      "require_approval": Boolean,
      "requires_check_in": Boolean,
      "require_subject": Boolean,
      "reservable_quantity": Number,
      "site": {Object},
      "standard_services": [Array],
      "sys_id": "String",
      "title": "String",
      "type": "String",
      "tableName": "String"
    }
  ]
}
    result.allow_invitees 직원이 예약에 초대 대상자를 추가할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 직원이 예약에 초대 대상자를 추가할 수 있습니다.
    • false: 직원이 예약에 초대 대상자를 추가할 수 없습니다.

    데이터 유형: 부울
    결과.영역 예약 가능한 항목이 위치한 영역입니다.

    이 정보는 영역 [sn_wsd_core_area] 테이블에 있습니다.

    "area": {
   "display_value": "String",
   "sys_id": "String"
}
    result.area.display_value 영역에 대한 값을 표시합니다.

    데이터 유형: 문자열
    result.area.sys_id 연결된 영역 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.건물 예약 가능한 항목이 위치한 건물입니다.

    이 정보는 건물 [sn_wsd_core_building] 테이블에 있습니다.

    "building": {
  "display_value": "String",
  "sys_id": "String",
  "timezone": {Object}
}
    result.building.display_value 건물의 가치를 표시합니다.

    데이터 유형: 문자열
    result.building.sys_id 관련된 건물 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.건물.시간대 건물의 시간대에 대한 상세 정보입니다.
    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.building.timezone.display_value 연결된 건물이 위치한 시간대의 표시 값입니다.

    데이터 유형: 문자열
    결과.건물.시간대.값 연결된 건물이 위치한 시간대의 내부 값입니다.

    데이터 유형: 문자열
    결과.캠퍼스 예약 가능한 항목이 위치한 캠퍼스입니다.

    이 정보는 캠퍼스 [sn_wsd_core_campus] 테이블에 있습니다.

    "campus": {
  "display_value": "String",
  "sys_id": "String"
}
    result.campus.display_value 캠퍼스의 값을 표시합니다.

    데이터 유형: 문자열
    result.campus.sys_id 연결된 캠퍼스 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.용량 예약 가능한 인원으로 수용할 수 있는 사용자 수입니다.

    데이터 유형: 숫자
    결과.설명

    예약 가능한 항목에 대한 설명입니다.

    데이터 유형: 문자열
    result.display_number_of_attendees 사용자가 예약의 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 참석자 수를 지정할 수 있습니다.
    • false: 사용자가 참석자의 표시 수를 지정할 수 없습니다.

    데이터 유형: 부울
    result.display_on_behalf_of 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 지원됩니다.
    • false: 지원되지 않는 대신 사용됩니다.

    데이터 유형: 부울
    result.display_sensitivity 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 민감도를 설정할 수 있습니다.
    • false: 민감도를 설정할 수 없습니다. 일반이 기본값으로 설정됩니다.

    데이터 유형: 부울
    result.email 예약 가능한 항목에 연결된 이메일 주소입니다.

    데이터 유형: 문자열
    result.employee_override_privacy 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있는지 여부를 나타내는 플래그입니다.

    이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 설정 및 영향을 참조하세요.

    유효한 값은 다음과 같습니다.
    • true: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 있습니다.
    • false: 사용자가 연결된 예약 가능 항목에 대한 개인정보 설정을 재정의할 수 없습니다.
    result.enable_group_reservations 사용자가 그룹 예약을 할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 단체 예약이 가능합니다.
    • false: 그룹 예약을 할 수 없습니다.

    데이터 유형: 부울
    result.enable_reservation_privacy

    예약 개인 정보에 대한 기본 설정을 나타내는 플래그입니다.

    이러한 개인 정보 설정에 대한 자세한 내용은 을 참조하십시오 Location privacy settings and impact.

    가능한 값:
    • true: 기본적으로 예약이 비공개입니다.
    • false: 기본적으로 예약은 비공개가 아닙니다.

    데이터 유형: 부울
    result.external_id 예약 가능한 항목의 외부 ID입니다.

    데이터 유형: 문자열
    result.flexible_services 매개변수가 true로 설정되고 workplace case management 플러그인이 설치된 경우에만 include_flexible_services 채워집니다. 예약 가능한 항목과 연결된 유연 서비스에 대한 설명입니다. 상위 유연 서비스와 여러 하위 유연 서비스가 있을 수 있습니다.

    이 정보는 [sn_wsd_case_workplace_service_item] 테이블에 있습니다.

    flexible_services": [
  {
    "additional_text": "String",
    "allow_only_single_service_item_selection": Boolean,
    "category": "String",
    "currency_code": "String",
    "flexible_service": [Array],
    "label": "String",
    "sub_category": "String",
    "sub_title": "String",
    "text": "String",
    "title": {Object}
  }
]
    result.flexible_services.additional_text 사용자에게 유연 서비스를 추가로 선택하라는 메시지를 표시하는 텍스트입니다.

    데이터 유형: 문자열
    result.flexible_services.allow_only_single_service_item_selection 사용자가 예약 내의 유연 서비스 그룹에서 하나의 서비스 항목만 선택할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 단일 항목만 선택할 수 있습니다.
    • false: 여러 항목을 선택할 수 있습니다.

    데이터 유형: 부울
    result.flexible_services.카테고리 유연 서비스의 범주입니다.

    데이터 유형: 문자열
    result.flexible_services.currency_code 유연 서비스를 주문할 때 통화 금액을 계산하는 데 사용되는 통화 코드입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service 상위 유연 서비스에 해당하는 유연 서비스입니다. 이 정보는 [sn_wsd_case_workplace_service_item] 테이블에 있습니다.

    데이터 유형: 객체 배열

    "flexible_service": [
  {
    "flexible_service": [Array],
    "label": "String",
    "sub_category": "String"
 }
]
    result.flexible_services.flexible_service입니다.flexible_service 상위 유연 서비스에 해당하는 각 유연 서비스의 상세 정보입니다.

    데이터 유형: 객체 배열

    "flexible_service": [
  {
    "additional_text": "String",
    "capacity_enabled": Boolean,
    "category": "String",
    "category_label": "String",
    "cleanup_duration": "String",
    "image": "String",
    "max_capacity": Number,
    "name": "String",
    "preparation_duration": "String",
    "price_per_unit": {Object},
    "quantity_enabled": Boolean,
    "quantity_required": Boolean,
    "short_description": "String",
    "sub_category": "String",
    "sub_category_label": "String",
    "sub_title": "String",
    "sys_id": "String",
    "text": "String",
    "title": {Object}
  }
]
    result.flexible_services.flexible_service입니다.flexible_service.추가_텍스트 사용자에게 유연 서비스를 추가로 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.capacity_enabled 예약에 표시할 회의실의 수용 인원 여부를 나타내는 플래그입니다. true로 quantity_enabled 설정하면 항상 false가 됩니다.
    유효한 값은 다음과 같습니다.
    • true: 용량이 나타나야 합니다.
    • false: 용량이 표시되지 않아야 합니다.

    데이터 유형: 부울
    result.flexible_services.flexible_service입니다.flexible_service.카테고리 유연 서비스의 범주입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.category_label 유연 서비스의 범주 레이블입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.cleanup_duration 예약 가능한 항목에 추가된 서비스를 정리하거나 제거하는 데 걸리는 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    result.flexible_services.flexible_service입니다.flexible_service.이미지 유연 서비스의 이미지에 대한 링크입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.max_용량 예약 가능한 인원이 수용할 수 있는 최대 탑승자 수입니다.

    데이터 유형: 숫자
    result.flexible_services.flexible_service입니다.flexible_service.이름 유연 서비스의 이름입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.준비_기간 서비스를 예약 가능한 항목에 추가하는 데 걸리는 시간입니다.

    데이터 유형: 문자열

    단위: 밀리초
    result.flexible_services.flexible_service입니다.flexible_service.price_per_unit 유연 서비스를 예약 가능한 항목에 추가하는 비용에 대한 상세 정보입니다.

    데이터 유형: 객체

    "price_per_unit": {
  "code": "String",
  "value": "String"
}
    result.flexible_services.flexible_service입니다.flexible_service.price_per_unit.code GBP 또는 USD와 같이 비용을 계산할 때 사용할 통화 코드입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.price_per_unit.value 유연 서비스의 각 단위에 대한 비용(코드 매개변수에 정의된 통화)입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.quantity_enabled 수량 필드를 예약에 표시해야 하는지 여부를 나타내는 플래그입니다. true로 capacity_enabled 설정하면 항상 false가 됩니다.
    유효한 값은 다음과 같습니다.
    • true: 수량이 표시됩니다.
    • false: 수량이 표시되지 않아야 합니다.

    데이터 유형: 부울
    result.flexible_services.flexible_service입니다.flexible_service.수량_필수 수량이 필요한지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 수량이 필요합니다.
    • false: 필요하지 않은 수량입니다.

    데이터 유형: 부울

    result.flexible_services.flexible_service입니다.flexible_service.short_description

    		 유연 서비스에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sub_category 유연 서비스의 하위 범주 이름(예: chair_layout)입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sub_category_label 의자 레이아웃과 같은 유연 서비스의 하위 범주 레이블입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sub_title 하위 유연 서비스의 부제목 이름입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.sys_id 유연한 서비스의 Sys_id.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.텍스트 사용자에게 유연 서비스를 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service. 제목 UI에서 하위 유연 서비스를 추가하고 편집할 때 사용할 제목에 대한 상세 정보입니다.

    데이터 유형: 객체

    "title": {
  "add": "String",
  "edit": "String"
}
    result.flexible_services.flexible_service입니다.flexible_service.제목.추가 UI에서 하위 유연 서비스를 추가할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.flexible_service.제목.편집 UI에서 하위 유연 서비스를 편집할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service.label 유연 서비스 레이블.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.sub_category 의장 추가와 같은 상위 유연 서비스의 하위 범주입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service입니다.sub_title 상위 유연 서비스의 부제목 이름입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service.text 사용자에게 상위 유연 서비스를 선택하라는 메시지를 표시하는 데 사용되는 텍스트입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service.title UI에서 상위 유연 서비스를 추가하고 편집할 때 사용할 제목에 대한 상세 정보입니다.

    데이터 유형: 객체

    "title": {
  "add": "String",
  "edit": "String"
}
    result.flexible_services.flexible_service.title입니다.추가 UI에서 상위 유연 서비스를 추가할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    result.flexible_services.flexible_service.title입니다.편집 UI에서 상위 유연 서비스를 편집할 때 사용되는 제목입니다.

    데이터 유형: 문자열
    결과.바닥 예약 가능한 층이 있는 층에 대한 상세 정보입니다.

    층 [sn_wsd_core_floor] 테이블에 있습니다.

    "floor": {
  "display_value": "String",
  "sys_id": "String"
}
    result.floor.display_value 예약 가능한 층이 있는 층의 번호(예: 12)를 표시합니다.

    데이터 유형: 문자열
    result.floor.sys_id 층 테이블에 있는 관련 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.이미지 연결된 예약 가능 항목을 나타내는 이미지의 상세 정보입니다.

    이미지 [db_image] 테이블에 있습니다.

    "image": {
  "link": "String",
  "sys_id": "String"
}
    result.image.link 예약 가능한 항목을 나타내는 이미지로 연결되는 링크입니다.

    데이터 유형: 문자열
    result.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.is_reservable 유연 서비스를 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 유연한 서비스를 예약할 수 있습니다.
    • false: 유연 서비스를 예약할 수 없습니다.

    데이터 유형: 부울
    결과.레이아웃 매개변수가 true로 설정된 경우에만 include_layouts 채워집니다.

    예약 가능한 항목과 연결된 레이아웃의 목록입니다.

    데이터 유형: 객체 배열

    "layouts": [
  {
    "capacity": Number,
    "cleanup_duration": "String",
    "image": {Object},
    "is_default": Boolean,
    "max_capacity": Number,
    "name": "String",
    "preparation_duration": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    결과.레이아웃.용량 회의에 참석할 사람 수입니다.

    데이터 유형: 숫자
    result.layouts.cleanup_duration 이 레이아웃의 예약 가능 항목을 정리하는 데 걸리는 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    결과.레이아웃.이미지 연결된 예약 가능한 항목의 레이아웃을 나타내는 이미지의 상세 정보입니다.

    이미지 [db_image] 테이블에 있습니다.

    "image": {
  "link": "String",
  "sys_id": "String"
}
    result.layouts.image.link 이 예약 가능한 항목의 레이아웃을 나타내는 이미지로 연결되는 링크입니다. 이미지 [db_image] 테이블에 있습니다.

    데이터 유형: 문자열
    result.layouts.image.sys_id 연결된 이미지 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.layouts.is_default 연결된 레이아웃이 예약 가능한 항목의 기본값인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 기본값입니다.
    • false: 기본값이 아닙니다.

    데이터 유형: 부울
    result.layouts.max_capacity 예약 가능한 것과 연결된 레이아웃이 수용할 수 있는 최대 사용자 수입니다.

    데이터 유형: 숫자
    result.layouts.name 위치 레이아웃의 이름입니다.

    데이터 유형: 문자열
    result.layouts.preparation_duration 연결된 위치 레이아웃을 준비하는 데 걸리는 시간입니다.

    데이터 유형: 숫자

    단위: 밀리초
    result.layouts.short_description 위치 레이아웃에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.layouts.sys_id 위치 레이아웃의 Sys_id.

    레이아웃 [sn_wsd_rsv_layout] 테이블에 있습니다.

    데이터 유형: 문자열
    result.location_type 직장/책상, 카페, 체육관 등 예약 가능한 위치의 유형에 대한 상세 정보입니다.

    공간 유형 [sn_wsd_core_space_type] 테이블에 있습니다.

    "location_type": {
  "display_value": "String",
  "sys_id": "String"
}
    result.location_type.display_value 위치 유형의 표시 값입니다.

    데이터 유형: 문자열
    result.location_type.sys_id 공간 유형 [sn_wsd_core_space_type] 테이블에 있는 관련된 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.meetingProviders 예약 가능한 항목과 연결된 가상 회의 제공자에 대한 상세 정보입니다.

    이 정보는 가상 회의 공급자 [sn_wsd_rsv_virtual_meeting_provider] 테이블에 있습니다.

    "meetingProviders": [
  {
    "display_value": "String",
    "value": "String"
  }
]
    result.meetingProviders.display_value 가상 제공자 이름의 값을 표시합니다.

    데이터 유형: 문자열
    result.meetingProviders.value 기록에 있는 가상 제공자 이름의 실제 값입니다.

    데이터 유형: 문자열
    result.moduleType 책상 또는 회의실과 같이 예약 가능한 항목과 연결된 예약 가능한 모듈입니다.

    데이터 유형: 문자열
    result.name 예약 가능한 항목의 이름입니다.

    데이터 유형: 문자열
    result.number 예약 가능한 항목의 고유 식별자입니다. 이 값은 sys_id보다 사람이 더 쉽게 읽을 수 있습니다.

    데이터 유형: 문자열
    결과.순서 예약 가능한 항목의 순서 번호입니다.

    데이터 유형: 숫자
    result.require_approval 예약 가능한 항목을 예약하는 데 승인이 필요한지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 승인이 필요합니다.
    • false: 승인이 필요하지 않습니다.

    데이터 유형: 부울
    result.requires_check_in 예약 가능한 항목의 사용자 체크인이 필요한지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 체크인이 필요합니다.
    • false: 체크인이 필요하지 않습니다.

    데이터 유형: 부울
    result.require_subject 예약 시 사용자가 제목을 입력해야 하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 제목이 필수입니다.
    • false: 제목이 필요하지 않습니다.

    데이터 유형: 부울
    result.reservable_quantity 연결된 예약 가능한 시간을 동시에 예약할 수 있는 최대 횟수입니다. 이 값은 영역에 인접한 공간을 할당할 때 사용됩니다.

    데이터 유형: 정수
    result.site 예약 가능한 서버가 있는 현장에 대한 상세 정보입니다.

    사이트 [sn_wsd_core_site] 테이블에 있습니다.

    "site": {
  "display_value": "String",
  "sys_id": "String"
}
    result.site.display_value 사이트의 표시 값입니다.

    데이터 유형: 문자열
    result.standard_services 매개변수가 true로 설정된 경우에만 include_standard_services 채워집니다.
    플립 차트, 프로젝터 스크린, 화이트보드 및 마커와 같은 연관된 표준 서비스입니다.

    데이터 유형: 객체 배열

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.standard_services.font_awesome_icon 표준 서비스와 연결된 썸네일 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.standard_services.name 표준 서비스의 이름입니다.

    데이터 유형: 문자열
    result.standard_services.short_description 표준 서비스에 대한 간략한 설명입니다.

    데이터 유형: 문자열
    result.standard_services.sys_id 표준 서비스 기록의 Sys_id입니다. 표준 서비스 [sn_wsd_rsv_standard_service] 테이블에 있습니다.

    데이터 유형: 문자열
    result.site.sys_id 사이트 [sn_wsd_core_site] 테이블에 있는 연결된 사이트 기록의 Sys_id입니다.

    데이터 유형: 문자열
    result.tableName 예약 가능한 기록이 있는 테이블의 이름입니다.

    데이터 유형: 문자열
    결과.제목 예약 가능한 항목의 제목입니다.

    데이터 유형: 문자열
    결과.유형 위치와 같은 예약 가능한 유형입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 이 끝점을 호출하여 지정된 예약 가능 항목에 대한 세부 정보를 반환하는 방법을 보여 줍니다.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/v2/reservable/list_reservables" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"space_sys_ids\":\"3ed3139977220110b3d7be377b5a99d1\",\"reservable_module_sys_id\":\"c31241cedb7650106c731dcd13961917\",\"include_flexible_services\":true,\"include_standard_services\":true,\"include_reservable_purposes\":true,\"include_layouts\":false}" \
--user 'username:'password'

    응답 본문입니다. 이 예에서는 요청 본문에 나열된 모든 예약 가능 항목에 대한 세부 정보를 반환합니다.

    {
  "result": [
    {
      "sys_id": "3ed3139977220110b3d7be377b5a99d1",
      "external_id": "447b9dfb475a011064062782846d4382",
      "wsd_email": null,
      "name": "A263",
      "title": "A263",
      "description": null,
      "image": null,
      "number": "ROOM0000181",
      "site": {
        "sys_id": "b35f47ffdba05010f342a0da4b961998",
        "display_value": "Italy"
      },
      "campus": {
        "sys_id": "87831b1977220110b3d7be377b5a9946",
        "display_value": ""
      },
      "building": {
        "sys_id": "dea39b1977220110b3d7be377b5a9955",
        "display_value": "",
        "timezone": {
          "value": "",
          "displayValue": ""
        }
      },
      "floor": {
        "sys_id": "68d31f5977220110b3d7be377b5a991b",
        "display_value": ""
      },
      "area": null,
      "capacity": "17",
      "reservable_quantity": "1",
      "location_type": {
        "sys_id": "20713b83eb512010b89bfdfc9c522899",
        "display_value": "Room"
      },
      "order": null,
      "requires_check_in": null,
      "is_reservable": "1",
      "type": "location",
      "moduleType": "Meeting rooms",
      "meetingProviders": [],
      "require_subject": true,
      "allow_invitees": false,
      "display_number_of_attendees": false,
      "display_on_behalf_of": true,
      "display_sensitivity": true,
      "enable_group_reservations": false,
      "allow_reservation_message": false,
      "warn_employee_for_duplicate_reservation": false,
      "enable_reservation_privacy": false,
      "employee_override_privacy": false,
      "tableName": "sn_wsd_core_room",
      "require_approval": false,
      "flexible_services": [
        {
          "allow_only_single_service_item_selection": true,
          "category": "50723fbf07100110c9b36b6e0ad300b4",
          "label": "Space arrangement",
          "description": "This is a service to request a different space configuration as part of a reservation.",
          "sub_category": "chair_layout",
          "title": {
            "edit": "Update Space arrangement for A263",
            "add": "Add Space arrangement for A263"
          },
          "sub_title": "Add a space arrangement item to get started",
          "text": "Select space arrangement item",
          "additional_text": "Select another space arrangement item",
          "currency_code": "GBP",
          "flexible_service": [
            {
              "sub_category": "chair_layout",
              "label": "Chair layout",
              "flexible_service": [
                {
                  "sys_id": "e2ecf7b307500110c9b36b6e0ad30033",
                  "name": "Classroom Style",
                  "short_description": "Rows of tables arranged with all participants facing towards the front of the room",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "08d6ff68d5122110fa9b1500c1d696c5.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                },
                {
                  "sys_id": "1cf33fff07100110c9b36b6e0ad30077",
                  "name": "Banquet Rounds",
                  "short_description": "Round tables arranged throughout the room. Participants are seated around the entire perimeter of each table",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "cdc67720d5522110fa9b1500c1d69636.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                },
                {
                  "sys_id": "21e2c08407600110c9b36b6e0ad3007c",
                  "name": "Theater Style",
                  "short_description": "Rows of chairs (no tables) arranged with all participants facing towards the front of the room",
                  "category": "50723fbf07100110c9b36b6e0ad300b4",
                  "category_label": "Space arrangement",
                  "sub_category": "chair_layout",
                  "sub_category_label": "Chair layout",
                  "image": "f3d67fa4d5122110fa9b1500c1d6968b.iix",
                  "quantity_enabled": false,
                  "quantity_required": false,
                  "capacity_enabled": true,
                  "max_capacity": "",
                  "preparation_duration": "1970-01-01 00:15:00",
                  "cleanup_duration": "1970-01-01 00:15:00",
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Space arrangement for A263",
                    "add": "Add Space arrangement for A263"
                  },
                  "sub_title": "Add a space arrangement item to get started",
                  "text": "Select space arrangement item",
                  "additional_text": "Select another space arrangement item"
                }
              ]
            }
          ]
        },
        {
          "allow_only_single_service_item_selection": false,
          "category": "c9ab1c89c3500110547e3810a840dd41",
          "label": "Catering",
          "description": "This is a service to request catering as part of a reservation.",
          "sub_category": "drinks",
          "title": {
            "edit": "Update Catering for A263",
            "add": "Add Catering for A263"
          },
          "sub_title": "Add a catering item to get started",
          "text": "Select catering item",
          "additional_text": "Select another catering item",
          "currency_code": "GBP",
          "flexible_service": [
            {
              "sub_category": "drinks",
              "label": "Drinks",
              "flexible_service": [
                {
                  "sys_id": "48d72985c3900110547e3810a840dd7d",
                  "name": "Champagne",
                  "short_description": "",
                  "category": "c9ab1c89c3500110547e3810a840dd41",
                  "category_label": "Catering",
                  "sub_category": "drinks",
                  "sub_category_label": "Drinks",
                  "image": "",
                  "quantity_enabled": true,
                  "quantity_required": false,
                  "capacity_enabled": false,
                  "max_capacity": "",
                  "preparation_duration": 0,
                  "cleanup_duration": 0,
                  "price_per_unit": {
                    "value": 0,
                    "code": "GBP"
                  },
                  "title": {
                    "edit": "Update Catering for A263",
                    "add": "Add Catering for A263"
                  },
                  "sub_title": "Add a catering item to get started",
                  "text": "Select catering item",
                  "additional_text": "Select another catering item"
                }
              ]
            }
          ]
        }
      ],
      "standard_services": [],
      "reservable_purposes": []
    }
  ]
}