WSD 정기 예약 API

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 92분
  • 워크플레이스 서비스 제공 (WSD) 반복 예약 API는 동시에 발생하지만 날짜가 다른 예약을 관리하기 위한 엔드포인트를 제공합니다.

    이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 안전 관리(sn_wsd_core) 및 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.

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

    에 대한 워크플레이스 예약 관리자세한 내용은 워크플레이스 예약 관리를 참조하십시오.

    WSD 정기 예약 - GET /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}

    지정된 반복 예약을 반환합니다.

    예약에 6개 이상의 반복 회의 발생이 가능한 경우 쿼리 매개변수를 사용하여 발생한 항목을 페이지 매김할 수 있습니다. 반환하지 않도록 발생 기록을 지정할 수도 있습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/list/{parent_id}

    기본 URL: /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    parent_id 반복 상위 예약 기록의 Sys_id입니다.

    반복 예약이 생성되면 하나의 반복 상위 기록과 하나 이상의 하위 예약 기록이 생성됩니다. 예약 기록에는 예약 기록의 유형을 나타내는 reservation_subtype라는 필드가 있습니다. 반복되는 상위 기록의 경우 이 필드는 "되풀이 상위 항목"으로 설정됩니다. 하위 기록의 경우 이 필드는 "발생"으로 설정됩니다.

    하위 기록 내에서 연결된 반복 상위 기록의 sys_id은 source_reservation 필드에 있습니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    표 2. 쿼리 매개변수
    이름 설명
    end_index 반복 기록 세트를 통해 페이지 매김할 때 발생 기록 반환을 중지할 0부터 시작하는 기록 번호입니다.
    주:
    반복 발생 횟수가 6개 미만이면 엔드포인트는 모든 발생을 반환하고, 그렇지 않으면 처음 6개 항목을 반환합니다. 6회를 초과하는 발생을 검색하려면 그에 따라 end_index 매개변수를 전달해야 합니다.

    데이터 유형: 숫자

    occurrence_sys_id 반복 계열의 발생 기록이 반환되지 않는 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    start_index 반복 기록 세트를 페이지 매김할 때 발생 기록 반환을 시작할 0부터 시작하는 기록 번호입니다.

    데이터 유형: 숫자

    기본값: 0

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

    헤더

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

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

    기본값: application/json

    표 5. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 요청된 반복 예약에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
      "occurencesTotalCount": "String",
      "reservation": {Object}
    }
    result.occurencesTotalCount 반복 계열의 총 회의 발생 횟수입니다.

    데이터 유형: 문자열

    결과.예약 요청된 반복 예약에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation": {
      "active": Boolean,
      "attendees": [Array],
      "check_in_state": {Object},
      "edit_restriction": {Object},
      "end": "String",
      "external_ical": "String",
      "external_id": "String",
      "is_parent": Boolean,
      "last_updated_sub_source": {Object},
      "location": {Object},
      "notification_custom_message": "String",
      "notification_recipients": [Array],
      "number": "String",
      "number_of_attendees": Number,
      "opened_by": {Object},
      "recording_details": [Array],
      "recurring_pattern": {Object},
      "requested_for": {Object},
      "reservable_module": {Object},
      "sensitivity": {Object},
      "shift": {Object},
      "source": {Object},
      "source_icon": {Object},
      "source_reservation": {Object},
      "source_reservation_requester": {Object},
      "start": "String",
      "state": {Object},
      "subject": "String",
      "sub_source": {Object},
      "sync_state": {Object},
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_updated_on": "String",
      "virtual_meeting": "String"
    }
    result.reservation.active 예약이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약이 활성 상태입니다.
    • false: 예약이 비활성 상태입니다.

    데이터 유형: 부울

    결과.예약.참석자 예약 참석자 목록입니다.

    데이터 유형: 객체 배열

    "attendees": [
      {
        "avatar": "String",
        "displayValue": "String",
        "display_value": "String",
        "email": "String",
        "initials": "String",
        "label": "String",
        "name": "String",
        "sys_id": "String",
        "table": "String",
        "user_name": "String",
        "value": "String"
      }
    ]
    결과.예약.참석자.아바타 참석자와 연결된 아바타의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]

    result.reservation.attendees.displayValue 참석자에 대한 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.attendees.display_value 참석자의 값을 표시합니다. 와 동일합니다.displayValue

    데이터 유형: 문자열

    result.reservation.attendees.email 참석자의 이메일 주소입니다.

    데이터 유형: 문자열

    result.reservation.attendees.initials 참석자의 이니셜입니다.

    데이터 유형: 문자열

    result.reservation.attendees.name 참석자 이름입니다.

    데이터 유형: 문자열

    result.reservation.attendees.sys_id 참석자 기록의 Sys_id입니다.

    데이터 유형: 문자열

    result.reservation.attendees.table 참석자 기록이 있는 테이블입니다.

    데이터 유형: 문자열

    result.reservation.attendees.user_name 참석자의 사용자 이름입니다.

    데이터 유형: 문자열

    결과.예약.참석자.값 참석자의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.check_in_state 예약의 체크인 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "check_in_state": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.check_in_state.display_value 예약의 현재 체크인 상태에 대한 값을 표시합니다(예: 진행 중 또는 완료).

    데이터 유형: 문자열

    result.reservation.check_in_state.value 예약의 현재 체크인 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열

    result.reservation.edit_restriction 예약에 대한 사용자 편집 제한(예: no_restrictions, service_only 또는 fully_restricted)에 대한 설명입니다.

    데이터 유형: 객체

    "edit_restriction": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.edit_restriction.display_value 예약에 대한 편집 제한에 대한 값(예: 제한 없음)을 표시합니다.

    데이터 유형: 문자열

    result.reservation.edit_restriction.value 예약에 대한 편집 제한의 내부 값입니다( 예: no_restriction).

    데이터 유형: 문자열

    결과.예약.종료 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    result.reservation.external_ical 예약에 대한 고유한 외부 iCalendar ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다.

    데이터 유형: 문자열

    result.reservation.external_id 예약의 고유 외부 ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다.

    데이터 유형: 문자열

    result.reservation.is_parent 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 상위 예약입니다.
    • false: 상위 예약이 아닙니다.

    데이터 유형: 부울

    result.reservation.last_updated_sub_source 예약에 대해 마지막으로 업데이트된 하위 소스에 대한 상세 정보입니다. 하위 소스는 예약을 외부 달력과 통합할 때 사용됩니다. 이 객체에는 "servicenow_workplace_service_delivery", "google_calendar" 또는 "microsoft_exchange"과 같은 정보가 포함됩니다.

    데이터 유형: 객체

    "last_updated_sub_source": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.last_updated_sub_source.display_value 마지막으로 업데이트된 예약의 하위 소스에 대한 값( 예: ServiceNow 워크플레이스 서비스 제공 또는 Google 달력)을 표시합니다. 예약을 Google 달력 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다.

    데이터 유형: 문자열

    result.reservation.last_updated_sub_source.값 예약의 마지막 업데이트된 하위 소스에 대한 내부 값입니다( 예: servicenow_workplace_service_delivery 또는 google_calendar). 예약을 Google 달력 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다.

    데이터 유형: 문자열

    결과.예약.위치 예약과 관련된 위치에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location": {
      "area": {Object},
      "building": {Object},
      "campus": {Object},
      "capacity": Number,
      "description": "String",
      "display_value": "String",
      "email": "String",
      "floor": {Object},
      "label_value": "String",
      "name": "String",
      "number": "String",
      "number_of_attendees": Boolean,
      "region": {Object},
      "requested_for": {Object},
      "reservable_module": {Object},
      "reservation": {Object},
      "site": {Object},
      "state": {Object},
      "sys_id": "String"
    }
    결과.예약.위치.영역 위치와 연결된 영역에 대한 상세 정보입니다.

    데이터 유형: 객체

    "area": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.location.area.active 영역이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 영역이 활성 상태입니다.
    • false: 영역이 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.area.display_value 책상 A2와 같이 이 위치가 속한 영역의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.location.area.sys_id 이 위치가 속한 영역의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 영역 [sn_wsd_core_area]

    결과.예약.위치.건물 위치와 연결된 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

    "building": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String",
      "timezone": {Object}
    }
    result.reservation.location.building.active 건물이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 건물이 활성 상태입니다.
    • false: 건물이 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.building.display_value 이 위치가 속한 건물의 값을 표시합니다(예: AMS - Bld1).

    데이터 유형: 문자열

    result.reservation.location.building.sys_id 이 위치가 속한 건물의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 건물 [sn_wsd_core_building]

    결과.예약.위치.건물.시간대 건물의 표준 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
      "displayValue": "String",
      "value": "String"
    }
    result.reservation.location.building.timezone.display_value 관련된 건물이 위치한 시간대의 값을 표시합니다.

    데이터 유형: 문자열

    결과.예약.위치.건물.시간대.값 이 위치가 속한 시간대의 내부 값입니다.

    데이터 유형: 문자열

    결과.예약.위치.캠퍼스 위치와 연결된 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

    "campus": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.location.campus.active 캠퍼스가 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 캠퍼스가 활성 상태입니다.
    • false: 캠퍼스가 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.campus.display_value 암스테르담 캠퍼스와 같이 이 위치가 속한 캠퍼스의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.location.campus.sys_id 이 위치가 속한 캠퍼스의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 캠퍼스 [sn_wsd_core_campus]

    결과.예약.위치.용량 위치의 최대 거주 수입니다.

    데이터 유형: 숫자

    결과.예약.위치.설명 위치에 대한 간략한 설명입니다.

    데이터 유형: 문자열

    result.reservation.location.display_value 이 위치에 대해 UI에 표시할 값입니다.

    데이터 유형: 문자열

    result.reservation.location.email 위치의 이메일 주소입니다.

    데이터 유형: 문자열

    결과.예약.위치.층 위치와 연결된 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floor": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.location.floor.active 층이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 층이 활성 상태입니다.
    • false: 층이 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.floor.display_value 이 위치가 속한 층의 값을 표시합니다(예: 1층).

    데이터 유형: 문자열

    result.reservation.location.floor.sys_id 이 위치가 속한 층의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 층 [sn_wsd_core_floor]

    result.reservation.location.label_value 매개변수에 name 지정된 값의 유형입니다(예: 방 이름).

    데이터 유형: 문자열

    result.reservation.location.name 위치 이름입니다.

    데이터 유형: 문자열

    결과.예약.위치.번호 예약 번호입니다.

    데이터 유형: 문자열

    result.reservation.location.number_of_attendees 예약 참석자 수입니다.

    데이터 유형: 숫자

    result.reservation.location.reservable_module 예약과 관련된 예약 가능한 모듈에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_module": {
      "inline_title": "String",
      "name": "String",
      "sys_id": "String",
      "title": "String"
    }
    result.reservation.location.reservable_module.inline_title 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 함께 나타납니다.

    데이터 유형: 문자열

    result.reservation.location.reservable_module.이름 예약 가능한 모듈의 이름입니다.

    데이터 유형: 문자열

    result.reservation.location.reservable_module.sys_id 예약 가능한 모듈의 Sys_id입니다.

    데이터 유형: 문자열

    result.reservation.location.reservable_module.타이틀 예약 가능한 모듈의 제목입니다.

    데이터 유형: 문자열

    결과.예약.위치.지역 위치와 연결된 지역에 대한 상세 정보입니다.

    데이터 유형: 객체

    "region": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.location.region.active 지역이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 지역이 활성 상태입니다.
    • false: 지역이 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.region.display_value 이 위치가 속한 지역의 값을 표시합니다(예: 유럽).

    데이터 유형: 문자열

    result.reservation.location.region.sys_id 이 위치가 속한 지역의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 지역 [sn_wsd_core_region]

    결과.예약.위치.예약 위치와 관련된 예약에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation": {
      "active": Boolean,
      "number": "String",
      "number_of_attendees": Number,
      "requested_for": {Object},
      "state": {Object},
      "sys_id": "String"
    }
    result.reservation.location.reservation.active 예약이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약이 활성 상태입니다.
    • false: 예약이 비활성 상태입니다.

    데이터 유형: 부울

    결과.예약.위치.예약.번호 예약 번호입니다.

    데이터 유형: 문자열

    result.reservation.location.reservation.number_of_attendees 예약 참석자 수입니다.

    데이터 유형: 숫자

    result.reservation.location.reservation.requested_for 예약을 대신하여 요청한 사람에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
      "name": "String",
      "sys_id": "String",
      "user_name": "String"
    }
    result.reservation.location.reservation.requested_for.name 예약이 요청된 사용자의 이름입니다.

    데이터 유형: 문자열

    result.reservation.location.reservation.requested_for.sys_id 요청 대상 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    result.reservation.location.reservation.requested_for.user_name 예약이 요청된 사용자의 사용자 이름입니다.

    데이터 유형: 문자열

    결과.예약.위치.예약.상태 해당 위치의 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.location.reservation..state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열

    결과.예약.위치.예약..상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열

    result.reservation.location.site 위치가 속한 사이트입니다.

    데이터 유형: 객체

    "site": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String"
    }

    테이블: 사이트 [sn_wsd_core_site]

    result.reservation.location.site.active 사이트가 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사이트가 활성 상태입니다.
    • false: 사이트가 비활성 상태입니다.

    데이터 유형: 부울

    result.reservation.location.site.display_value 이 위치가 속한 사이트의 값을 표시합니다(예: 서유럽).

    데이터 유형: 문자열

    result.reservation.location.site.sys_id 이 위치가 속한 사이트의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사이트 [sn_wsd_core_site]

    result.reservation.location.standard_services 사용 가능한 표준 서비스입니다.

    데이터 유형: 문자열

    결과.예약.위치.상태 해당 위치의 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.location.state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열

    결과.예약.위치.상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열

    result.reservation.location.sys_id 연결된 위치 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]

    result.reservation.notification_custom_message 에 나열된 수신자에게 전송되는 알림에 대한 사용자 지정 메시지입니다.reservation.notification_recipients

    데이터 유형: 문자열

    result.reservation.notification_recipients 예약에 대한 알림을 받는 수신자 목록입니다.

    데이터 유형: 객체 배열

    "notification_recipients":[
      {
        "name": "String",
        "sys_id": "String",
        "user_name": "String"
      }
    ]
    result.reservation.notification_recipients.name 수신자 이름입니다.

    데이터 유형: 문자열

    result.reservation.notification_recipients.sys_id 수신자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    result.reservation.notification_recipients.user_name 수신자의 사용자 이름입니다.

    데이터 유형: 문자열

    결과.예약.번호 예약 기록의 고유 번호입니다. 이 값을 사용하여 예약을 쿼리할 수 있습니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    result.reservation.number_of_attendees 이 예약의 참석자 수입니다.

    데이터 유형: 숫자

    result.reservation.opened_by 예약을 생성한 사용자에 대한 세부 정보입니다.

    데이터 유형: 객체

    "opened_by": {
      "avatar": "String",
      "displayValue": "String",
      "display_value": "String",
      "email": "String",
      "initials": "String",
      "label": "String",
      "name": "String",
      "sys_id": "String",
      "table": "String",
      "user_name": "String",
      "value": "String"
    }
    result.reservation.opened_by.avatar 예약을 연 사용자의 아바타입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.displayValue 사용자가 연 값의 표시 값입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.display_value 사용자가 연 값의 표시 값입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.email 예약을 연 사용자의 이메일 주소입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.initials 예약을 연 사용자의 이니셜입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.name 예약을 연 사용자의 이름입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.user_name 예약을 연 사용자의 사용자 이름입니다.

    데이터 유형: 문자열

    result.reservation.opened_by.value 예약을 연 사용자의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.recording_details 예약(회의)과 관련된 기록에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "recording_details": [
      "recording_url": "String"
    ]
    result.reservation.recording_details.recording_url 예약과 관련된 기록의 URL입니다.

    데이터 유형: 문자열

    result.reservation.recurring_pattern 예약의 반복 패턴에 대한 상세 정보입니다.

    데이터 유형: 객체

    "recurring_pattern": {
      "amountOfDates": "String",
      "duration": Number,
      "label": "String",
      "options": {Object},
      "repeats": "String",
      "startDate":"String",
      "startDateGdt": {Object}
    }
    result.reservation.recurring_pattern.날짜의양 예약 가능 항목이 예약되는 날짜 수입니다.

    데이터 유형: 문자열

    result.reservation.recurring_pattern.duration
    예약 가능한 항목을 예약할 시간입니다.

    데이터 유형: 숫자

    단위: 초

    result.reservation.recurring_pattern.label 반복 예약에 대한 설명이 포함된 이름입니다.

    데이터 유형: 문자열

    result.reservation.recurring_pattern.options 반복 예약과 관련된 옵션에 대한 상세 정보입니다.

    데이터 유형: 객체

    "options": {
      "count": Number,
      "daysOfWeek": "String",
      "every": Number,
      "endDate": "String"
      "endDateGdt": {Object}
    }
    result.reservation.recurring_pattern.options입니다.세다

    패턴을 반복하는 횟수입니다.

    데이터 유형: 숫자

    result.reservation.recurring_pattern.options입니다.daysOfWeek

    예약 가능한 요일입니다.

    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats is weekly이고, count5이고, daysOfWeek 245이면 반환 결과에서 합계는 count*daysOfWeek.length(5*3=15)와 같습니다.

    데이터 유형: 문자열

    result.reservation.recurring_pattern.options입니다.모든 패턴 반복 간격입니다. 예를 들어 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다.
    주:
    이 설정은 매주 반복 간격에는 적용되지 않습니다. 격주 반복 간격으로 속성을 매일로 설정하고 이 값을 14로 설정할 repeats 수 있습니다.

    데이터 유형: 숫자

    기본값: 1

    result.reservation.recurring_pattern.options입니다.종료 날짜 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss

    result.reservation.recurring_pattern.options입니다.endDateGdt 회의가 반복되는 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: GDT(예: "2022-07-08T14:00:00Z")

    result.reservation.recurring_pattern.repeats

    예약 가능한 반복 패턴입니다.

    유효한 값: (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    주:
    패턴 반복 간격은 속성에 options.every 설정되어 있습니다. 주간 패턴에 대해 유일하게 유효한 반복 간격은 1입니다.

    데이터 유형: 문자열

    result.reservation.recurring_pattern.startDate
    반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss

    result.reservation.recurring_pattern.startDateGdt
    반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss

    result.reservation.requested_for 예약을 대신한 사용자에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
      "avatar": "String",
      "displayValue": "String",
      "display_value": "String",
      "email": "String",
      "initials": "String",
      "label": "String",
      "name": "String",
      "sys_id": "String",
      "table": "String",
      "user_name": "String",
      "value": "String"
    }
    result.reservation.requested_for.avatar 예약을 대신하여 이루어진 사용자의 아바타입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.displayValue 예약을 대신하여 이루어진 사용자의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.requested_for.display_value 예약을 대신하여 이루어진 사용자의 값을 표시합니다. displayValue와 동일합니다.

    데이터 유형: 문자열

    result.reservation.requested_for.email 예약을 대신한 사용자의 이메일 주소입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.initials 예약을 대신하여 이루어진 사용자의 이니셜입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.label 예약을 대신하여 이루어진 사용자의 레이블입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.name 예약을 대신하여 이루어진 사용자의 이름입니다.

    데이터 유형: 문자열

    result.rservation.requested_for.sys_id Sys_id_of 예약을 대신한 사용자입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    result.rservation.requested_for.table 사용자 기록이 포함된 테이블입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.user_name 예약을 대신한 사용자의 사용자 이름입니다.

    데이터 유형: 문자열

    result.reservation.requested_for.value 예약을 대신하여 이루어진 사용자의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module 요청된 예약 가능한 모듈에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_module": {
      "allow_invitees": Boolean,
      "allow_whole_day": Boolean,
      "apply_to_shift": Boolean,
      "browse_by_area_enabled": Boolean,
      "browse_near_a_person_enabled": Boolean,
      "buildingSysIds": [Array],
      "checkin_before_minutes": Number,
      "display_number_of_attendees": Boolean,
      "display_on_behalf_of": Boolean,
      "display_sensitivity": Boolean,
      "display_value": "String",
      "enable_browse_by_area": Boolean,
      "enable_browse_near_a_person": Boolean,
      "enable_facet_filter": Boolean,
      "enable_group_reservations": Boolean,
      "enable_ical_generation": Boolean,
      "font_awesome_icon": "String",
      "inline_title": "String",      
      "layout_mapping": {Object},
      "max_days_in_future": Number,
      "max_occurrences": Number,
      "name": "String",
      "override_approval_policy": "String",
      "require_cancel_notes": Boolean,
      "require_cc_dept_check": Boolean,
      "require_subject": Boolean,
      "reservable_columns": [Array],
      "reservable_container_field": "String",
      "reservable_filter": "String",
      "reservable_quantity_field": "String",
      "reservable_table": "String",
      "reservable_type": "String",
      "reservable_views": [Array],
      "reservation_paths": [Array],
      "search_limit": Number,
      "selection_type": "String",
      "short_description": "String",
      "show_map_view": Boolean,
      "sys_id": "String",
      "timeSlots": [Array],
      "title": "String",
      "virtual_meeting_provider": {Object}
    }
    result.reservation.reservable_module.allow_invitees 직원이 초대 대상자를 예약에 추가할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 직원이 예약에 초대 대상자를 추가할 수 있습니다.
    • false: 직원이 예약에 초대 대상자를 추가하는 것을 허용하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.allow_whole_day 사용자가 하루 종일 예약 가능한 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 하루 종일 예약할 수 있도록 허용합니다.
    • false: 사용자가 하루 종일 예약하도록 허용하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.apply_to_shift 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 교대조 기반 예약을 허용합니다.
    • false: 교대조 기반 예약을 허용하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.browse_by_area_enabled 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 예약 가능한 모듈을 영역별로 찾아볼 수 있도록 허용합니다.
    • 아니오: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.browse_near_a_person_enabled 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • false: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.buildingSysIds 예약 가능한 모듈과 연결된 건물 sys_ids 목록입니다.

    데이터 유형: 문자열 배열

    result.reservation.reservable_module.checkin_before_minutes 예약이 시작되기 전 사용자가 예약을 체크인할 수 있는 시간입니다.

    단위: 분

    데이터 유형: 숫자

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

    데이터 유형: 부울

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

    데이터 유형: 부울

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

    데이터 유형: 부울

    result.reservation.reservable_module.display_value 예약 가능한 모듈의 표시 값입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.enable_browse_by_area 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 동일합니다.browse_by_area_enabled
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 예약 가능한 모듈을 영역별로 찾아볼 수 있도록 허용합니다.
    • 아니오: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.enable_browse_near_a_person 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 다음과 같습니다. browse_near_a_person_enabled
    유효한 값은 다음과 같습니다.
    • true: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • false: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.enable_facet_filter 직장 항목에 대한 패싯 필터링이 활성화되어 있는지 여부를 나타내는 플래그입니다. 활성화하면 검색 결과에 따라 표시되는 필터 옵션이 표시됩니다. 사용자는 생성된 검색 결과에서 사용할 수 있는 항목만 필터에서 선택하여 사용할 수 있습니다.
    유효한 값은 다음과 같습니다.
    • true: 패싯 필터가 활성화됩니다.
    • false: 패싯 필터를 사용할 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.enable_group_reservations 사용자가 그룹 예약을 할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 그룹 예약이 가능합니다.
    • false: 그룹 예약을 할 수 없습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.enable_ical_generation 사용자가 예약에 대한 iCalendar를 생성할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: iCalendar 작성이 허용됩니다.
    • 아니오: iCalendar 생성은 허용되지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.font_awesome_icon 예약 가능한 모듈에 첨부된 글꼴 아이콘의 이름입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.inline_title 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 함께 나타납니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping 위치의 레이아웃 매핑 구조에 대한 상세 정보입니다. 이 데이터를 사용하여 UI에 정보를 배치합니다.

    데이터 유형: 객체

    "layout_mapping": {
      "body": [Array],
      "description": [Array],
      "image": "String",
      "subtitle": [Array],
      "subtitle_asc": [Array],
      "title": [Array]
    }
    result.reservation.reservable_module.layout_mapping.body 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 객체 배열

    "body": [
      {
        "field": "String",
        "field_to_display": "String",
        "icon": "String",
        "label": "String"
      }
    ]
    result.reservation.reservable_module.layout_mapping.body.field 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping.body.field_to_display 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping.body.icon 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping.body.label 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping.description 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 레이아웃 매핑에 대한 설명입니다.

    데이터 유형: 배열

    result.reservation.reservable_module.layout_mapping.이미지 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.layout_mapping.부제목 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 배열

    result.reservation.reservable_module.layout_mapping.subtitle_asc 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 배열

    result.reservation.reservable_module.layout_mapping.title 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 배열

    result.reservation.reservable_module.max_days_in_future 사용자가 예약 가능한 모듈을 예약할 수 있는 향후 최대 일수입니다.

    데이터 유형: 숫자

    result.reservation.reservable_module.max_occurrences 예약 가능한 모듈에 대해 반복 예약을 사용할 수 있는 경우의 최대 반복 예약 발생 횟수입니다.

    데이터 유형: 숫자

    result.reservation.reservable_module.name 예약 가능한 모듈의 이름입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.override_approval_policy 승인 정책을 구현하는 방법을 지정하는 옵션입니다.
    선택:
    • 재정의 없음: 승인 정책은 직장 공간 또는 회의실의 승인 필요 필드에 설정된 대로 구현됩니다.
    • 항상 승인 필요: 직장 공간 또는 회의실의 승인 필요 필드에 설정된 내용에 관계없이 승인 정책이 필요합니다.
    • 승인 필요 없음: 직장 공간 또는 회의실의 승인 필요l 필드에 설정된 내용에 관계없이 승인 정책이 제거됩니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.require_cancel_notes 예약 가능한 모듈을 취소하기 전에 사용자가 취소 메모를 입력해야 하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 취소 메모가 필요합니다.
    • false: 취소 메모가 필요하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.require_cc_dept_check 작업 공간 항목과 로그인한 사용자 간에 비용 센터 또는 부서 불일치가 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 불일치를 확인합니다.
    • false: 불일치를 확인하지 않습니다.

    데이터 유형: 부울

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

    데이터 유형: 부울

    result.reservation.reservable_module.reservable_columns 예약 가능한 열의 목록입니다.

    데이터 유형: 배열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]

    result.reservation.reservable_module.reservable_container_field 특정 영역의 책상 그룹과 같은 컨테이너의 수준입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_filter 연결된 예약 가능한 테이블에서 예약 가능한 항목을 필터링하는 데 사용되는 필터 조건입니다. 예약 가능한 테이블은 예약 가능한 모듈[sn_wsd_rsv_reservable_module] 테이블의 필드입니다. 이러한 필터 조건은 예약 가능한 테이블 필드에 포함된 테이블에 적용되었습니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_quantity_field 모든 공간의 예약 가능한 수량입니다. 이 수량은 지역에 인접 공간을 할당할 때 사용됩니다. 자세한 내용은 영역에 인접 공간 할당을 참고하십시오.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_table 예약 가능한 직장 항목이 포함된 테이블입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_type 위치와 같은 예약 가능한 항목의 유형입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_views 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 여러 뷰에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_views": {
      "iconClass": "String",
      "isDefault": Boolean,
      "label": "String",
      "order": Number,
      "type": "String"
    }

    테이블: 예약 가능한 뷰 [sn_wsd_rsv_reservable_view]

    result.reservation.reservable_module.reservable_views.icon클래스 예약 가능한 뷰의 아이콘 클래스입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_views.is기본값 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 기본값으로 설정합니다.
    • false: 기본값으로 만들지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.reservable_views.레이블 예약 가능한 뷰의 이름입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservable_views.order UI에서 예약 가능한 모듈의 뷰가 표시되는 순서입니다. UI에서는 낮은 순서 숫자가 먼저 옵니다. 주문 번호가 동일한 경우 임의의 순서가 할당됩니다.

    데이터 유형: 숫자

    result.reservation.reservable_module.reservable_views.유형 예약 가능한 뷰의 백엔드 이름입니다. 내부 처리에 사용됩니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservation_paths 모두 찾아보기, 사람 주변 탐색 등 예약 가능한 모듈과 연결된 예약 경로입니다.

    데이터 유형: 객체 배열

    "reservation_paths": [
      {
        "displayValue": "String",
        "value": "String"
      }
    ]
    result.reservation.reservable_module.reservation_paths.display_value 예약 경로에 대한 값(예: "사람 주변 탐색")을 표시합니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.reservation_paths.값 예약 경로의 내부 값입니다(예: "browse_near_a_person").

    데이터 유형: 문자열

    result.reservation.reservable_module.search_limit 사용자가 직장 위치를 검색할 때 반환할 최대 검색 결과 수입니다.

    데이터 유형: 숫자

    result.reservation.reservable_module.selection_type

    검색 결과에 표시할 선택 항목의 유형입니다.

    다음 옵션 중 하나일 수 있습니다.
    • 특정 단위: 검색 결과에는 모든 직장 항목이 표시됩니다.
    • 컨테이너: 검색 결과에 직장 항목의 상위 또는 컨테이너가 표시됩니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.short_description 예약 가능한 모듈에 대한 간략한 설명입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.show_map_view 예약 가능한 모듈에 대해 맵 뷰를 사용할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 맵 뷰를 사용합니다.
    • false: 맵 뷰를 활성화하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservable_module.sys_id 예약 가능한 모듈의 Sys_id입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.timeSlots 예약 가능한 모듈에 연결된 시간 슬롯에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    [
      {
        "name": "String",
        "short_description": "String",
        "slot_end": "String",
        "slot_start": "String",
        "sys_id": "String"
      }
    ]
    result.reservation.reservable_module.timeSlots.name 시간 슬롯의 이름입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.timeSlots.short_description 시간 슬롯에 대한 간략한 설명입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.timeSlots.slot_end 시간 슬롯의 종료 시간입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.timeSlots.slot_start 슬롯의 시작 시간입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.timeSlots.sys_id 시간 슬롯 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 시간 슬롯 [sn_wsd_rsv_time_slot]

    result.reservation.reservable_module.title 예약 가능한 모듈의 제목입니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.virtual_meeting_provider 예약 가능한 모듈과 연결된 가상 제공자에 대한 상세 정보입니다.

    데이터 유형: 객체

    "virtual_meeting_provider": {
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.reservable_module.virtual_meeting_provider.display_value 가상 회의 제공자의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.reservable_module.virtual_meeting_provider.sys_id 가상 회의 제공자의 Sys_id입니다.

    데이터 유형: 문자열

    result.reservation.reservationAcl. 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservationAcl": {
      "read": Boolean,
      "write": {Object}
    }
    result.reservation.reservationAcl.read 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 예약을 읽을 수 있는지 확인합니다.
    • 아니오: 사용자가 예약을 읽을 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservationAcl.write 연결된 예약에 대한 사용자의 쓰기 기능에 대한 상세 정보입니다.

    데이터 유형: 객체

    "write": {
      "allFields": Boolean,
      "fields": {Object},
      "record": Boolean
    }
    result.reservation.reservationAcl.write.allFields 사용자가 객체에 지정된 reservationACL.write.fields 모든 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다. 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 객체에 reservationACL.write.fields 지정된 모든 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 확인하지 않습니다.reservationACL.write.fields

    데이터 유형: 부울

    result.reservation.reservationAcl.write.fields 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다.

    데이터 유형: 객체

    "fields": {
      "location": Boolean,
      "number_of_attendees": Boolean,
      "requested_for": Boolean,
      "sensitivity": Boolean,
      "subject": Boolean
    }
    result.reservation.reservationAcl.write.fields.location 사용자가 이 예약의 위치 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 위치 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 위치 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservationAcl.write.fields.number_of_attendees 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 참석자 수 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 참석자 수 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservationAcl.write.fields.requested_for 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 요청 대상 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 요청 대상 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    결과.예약.예약Acl.쓰기.필드.민감도 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 민감도 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 민감도 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    결과.reservation.reservationAcl.write.fields.subject 사용자가 이 예약의 제목 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 제목 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 제목 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservationAcl.write.record 사용자가 전체 예약 기록에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 전체 예약 기록에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 전체 예약 기록에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울

    result.reservation.reservation_purpose 예약 목적에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_purpose": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.reservation_purpose.display_value 회사 회의와 같은 예약 목적의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.reservation_purpose.value 예약 목적의 내부 값입니다(예: company_meeting).

    데이터 유형: 문자열

    result.reservation.reservation_type 예약 유형에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_type": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.reservation_type.display_value 공간과 같은 예약 유형에 대한 표시 값입니다.

    데이터 유형: 문자열

    result.reservation.reservation_type.value 공간과 같은 예약 유형의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.reservation_subtype 예약의 하위 유형에 대한 상세 정보입니다. 하위 유형은 예약의 유형(예: 단일, 다중 상위, 다중 하위, 반복되는 상위 항목 또는 발생)을 나타냅니다.

    데이터 유형: 객체

    "reservation_subtype": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.reservation_subtype.display_value 예약의 하위 유형에 대한 값(예: 단일)을 표시합니다.

    데이터 유형: 문자열

    result.reservation.reservation_subtype.value 예약의 하위 유형에 대한 내부 값입니다(예: 단일).

    데이터 유형: 문자열

    결과.예약.민감도 예약의 민감도에 대한 상세 정보입니다.

    데이터 유형: 객체

    "sensitivity": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.sensitivity.display_value 예약의 민감도에 대한 값(예: 높음 또는 낮음)을 표시합니다.

    데이터 유형: 문자열

    결과.예약.민감도.값 예약 민감도의 내부 값(예: 1 또는 3)입니다.

    데이터 유형: 문자열

    결과.예약.교대조 예약에 적용된 교대조에 대한 상세 정보입니다.

    데이터 유형: 객체

    "shift": {
      "display_value": "String",
      "name": "String",
      "shiftDetails": "String",
      "sys_id": "String"
    }
    result.reservation.shift.display_value 교대조의 값을 표시합니다.

    데이터 유형: 문자열

    result.reservation.shift.name 교대조의 이름입니다. 와 동일합니다.display_value

    데이터 유형: 문자열

    결과.예약.교대조.교대조 상세 정보 교대조의 상세 정보입니다.

    데이터 유형: 문자열

    result.reservation.shift.sys_id 교대조 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]

    결과.예약.소스 예약 소스에 대한 상세 정보(예: 직장 서비스 또는 Google 메일)입니다.

    데이터 유형: 객체

    "source": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.source.display_value 직장 서비스와 같은 예약 소스에 대한 값을 표시합니다.

    데이터 유형: 문자열

    결과.예약.소스.값 ServiceNow와 같은 예약 소스의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.source_icon 예약에 사용된 아이콘의 소스에 대한 상세 정보입니다. 이 아이콘은 UI에서 사용됩니다.

    데이터 유형: 객체

    "source_icon": {
      "classNames": "String",
      "imgSrc": "String",
      "tooltip": "String"
    }
    result.reservation.source_icon.classNames 소스 아이콘의 쉼표로 구분된 클래스 이름입니다.

    데이터 유형: 문자열

    result.reservation.source_icon.imgSrc 소스 아이콘의 이미지 소스 이름입니다. 이 아이콘은 이미지 [db_image] 테이블에 저장됩니다.

    데이터 유형: 문자열

    result.reservation.source_icon.tooltip 소스 아이콘과 관련된 도구 설명입니다.

    데이터 유형: 문자열

    result.reservation.source_reservation 현재 예약의 소스 예약입니다. 예를 들어 반복 예약의 경우 반복 상위 예약은 일련의 발생 예약의 소스입니다.

    데이터 유형: 객체

    "source_reservation": {
      "display_value": "String",
      "name": "String",
      "sys_id": "String"
    }
    result.reservation.source_reservation.display_value 소스 예약의 표시 값입니다.

    데이터 유형: 문자열

    result.reservation.source_reservation.name 소스 예약의 이름입니다.

    데이터 유형: 문자열

    result.reservation.source_reservation.sys_id 소스 예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블:직장 예약 [sn_wsd_rsv_reservation]

    result.reservation.source_reservation_requester 반복 예약을 요청한 사용자입니다.

    데이터 유형: 객체

    "source_reservation": {
      "name": "String",
      "sys_id": "String",
      "user_name": "String"
    }
    result.reservation.source_reservation_requester.name 반복 예약 요청자의 이름입니다.

    데이터 유형: 문자열

    result.reservation.source_reservation_requester.sys_id 반복 예약을 요청한 사용자의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]

    result.reservation.source_reservation_requester.사용자_이름 반복 예약 요청자의 사용자 이름입니다.

    데이터 유형: 문자열

    결과.예약.시작 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    결과.예약.상태 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.state.display_value 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다.

    데이터 유형: 문자열

    결과.예약.상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열

    결과.예약.제목 예약의 제목입니다.

    데이터 유형: 문자열

    result.reservation.sub_source 예약의 하위 소스에 대한 상세 정보입니다. 하위 소스는 예약이 시작된 위치를 지정합니다(예: Google 달력 또는 Microsoft Exchange).

    데이터 유형: 객체

    "sub_source": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.sub_source.display_value 예약의 하위 소스에 대한 값(예: Google 달력)을 표시합니다.

    데이터 유형: 문자열

    result.reservation.sub_source.value 예약의 하위 소스 필드의 내부 값입니다(예: google_calendar).

    데이터 유형: 문자열

    result.reservation.sync_state 다른 서비스에서 예약의 동기화 상태에 대한 상세 정보입니다(예: "sync_enqueued" 또는 "동기화됨").

    데이터 유형: 객체

    "sync_state": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.sync_state.display_value 예약의 현재 동기화 상태에 대한 값(예: 동기화됨)을 표시합니다.

    데이터 유형: 문자열

    result.reservation.sync_state.value 예약의 현재 동기화 상태(예: 동기화됨)의 내부 값입니다.

    데이터 유형: 문자열

    result.reservation.sys_created_on 예약이 생성된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.reservation.sys_id
    예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    Result.reservation.sys_updated_on 예약이 마지막으로 업데이트된 날짜 및 시간입니다.

    데이터 유형: 문자열

    result.reservation.virtual_meeting 가상 회의 링크의 URL입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 특정 반복 예약을 검색하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/list/d98a381587b789506342b846dabb3563" \
    --request GET \
    --header "Accept:application/json" \
    --user "username": "password"
    

    반환 결과:

    {
      "result": {
        "reservations": [
          {
            "sys_id": "198a381587b789506342b846dabb3565",
            "number": "WRES0001247",
            "location": {
              "sys_id": "fe1f744edb7650106c731dcd139619ca",
              "name": "Aspen",
              "description": "A room with large windows, dark leather seats and a large wooden table.",
              "display_value": "Aspen",
              "capacity": 16,
              "label_value": "Room name",
              "email": null,
              "reservable_module": {
                "sys_id": "c31241cedb7650106c731dcd13961917",
                "name": "Meeting rooms",
                "title": "Meeting rooms",
                "inline_title": "meeting room"
              },
              "region": {
                "sys_id": "3752ac8edb3650106c731dcd139619e0",
                "display_value": "Americas",
                "active": true
              },
              "site": {
                "sys_id": "628eec06db7650106c731dcd139619dd",
                "display_value": "North America",
                "active": true
              },
              "campus": {
                "sys_id": "82b2a0cedb3650106c731dcd139619e9",
                "display_value": "California Campus",
                "active": true
              },
              "building": {
                "sys_id": "94e264cedb3650106c731dcd13961919",
                "display_value": "CAL-B1",
                "active": true,
                "timezone": {
                  "value": "US/Pacific",
                  "displayValue": "US/Pacific"
                }
              },
              "floor": {
                "sys_id": "2f554296dbba10106c731dcd139619ed",
                "display_value": "Floor 2",
                "active": true
              },
              "area": {
                "sys_id": "",
                "display_value": "",
                "active": false
              },
              "reservation": {
                "sys_id": "198a381587b789506342b846dabb3565",
                "number_of_attendees": 1,
                "state": {
                  "value": "confirmed",
                  "display_value": "Confirmed"
                },
                "requested_for": {
                  "sys_id": "2de07e1887cb89106342b846dabb35fe",
                  "name": "Workplace User",
                  "user_name": "workplace_user"
                },
                "number": "WRES0001247",
                "active": true
              },
              "number_of_attendees": 1,
              "state": {
                "value": "confirmed",
                "display_value": "Confirmed"
              },
              "number": "WRES0001247",
              "requested_for": {
                "sys_id": "2de07e1887cb89106342b846dabb35fe",
                "name": "Workplace User",
                "user_name": "workplace_user"
              }
            },
            "start": "2022-06-11T13:00:00Z",
            "end": "2022-06-11T14:00:00Z",
            "sys_created_on": "2022-05-30T07:06:37Z",
            "sys_updated_on": "2022-05-30T07:06:40Z",
            "source_reservation": {
              "sys_id": "d98a381587b789506342b846dabb3563",
              "display_value": "WRES0001246",
              "name": "WRES0001246"
            },
            "check_in_state": {
              "value": "not_required",
              "display_value": "Not required"
            },
            "external_id": null,
            "external_ical": null,
            "active": true,
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "sensitivity": {
              "value": "normal",
              "display_value": "Normal"
            },
            "reservation_type": {
              "value": "space",
              "display_value": "Space"
            },
            "reservation_subtype": {
              "value": "occurrence",
              "display_value": "Occurrence"
            },
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "attendees": null,
            "number_of_attendees": 1,
            "is_parent": false,
            "subject": "Rec 1",
            "virtual_meeting": null,
            "recording_details": [],
            "sync_state": {
              "value": "not_required",
              "display_value": "Synchronization not required"
            },
            "sub_source": {
              "value": "servicenow_workplace_service_delivery",
              "display_value": "ServiceNow Workplace Service Delivery"
            },
            "last_updated_sub_source": {
              "value": "servicenow_workplace_service_delivery",
              "display_value": "ServiceNow Workplace Service Delivery"
            },
            "reservable_module": {
              "sys_id": "c31241cedb7650106c731dcd13961917",
              "name": "Meeting rooms",
              "title": "Meeting rooms",
              "inline_title": "meeting room",
              "font_awesome_icon": "fa-building",
              "reservable_table": "sn_wsd_core_room",
              "reservable_filter": "active=true^is_reservable=true^building!=6c0364cedb3650106c731dcd13961927^building.is_reservable=true^floor.is_reservable=true^EQ",
              "short_description": "Reserve a meeting room",
              "reservable_type": "location",
              "require_subject": "1",
              "require_cancel_notes": true,
              "virtual_meeting_provider": {
                "sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
                "display_value": "Template"
              },
              "allow_invitees": "1",
              "display_number_of_attendees": "1",
              "display_on_behalf_of": "1",
              "display_sensitivity": "1",
              "max_days_in_future": "180",
              "allow_recurring": "1",
              "allow_whole_day": "1",
              "require_whole_day": null,
              "selection_type": "unit",
              "reservable_container_field": null,
              "reservable_quantity_field": null,
              "apply_to_shift": null,
              "max_occurrences": "180",
              "enable_facet_filter": false,
              "search_limit": 10000,
              "enable_ical_generation": "1",
              "enable_group_reservations": null,
              "enable_browse_near_a_person": "1",
              "enable_browse_by_area": "1",
              "enable_floor_search": "1",
              "display_value": "Meeting rooms",
              "browse_near_a_person_enabled": true,
              "browse_by_area_enabled": true,
              "reservable_columns": [
                "sys_id",
                "external_id",
                "email",
                "name",
                "title",
                "description",
                "image",
                "number",
                "site",
                "campus",
                "building",
                "floor",
                "area",
                "capacity",
                "reservable_quantity",
                "location_type",
                "order",
                "requires_check_in",
                "is_reservable"
              ],
              "layout_mapping": {
                "title": [
                  "name"
                ],
                "description": [
                  "description"
                ],
                "subtitle": [
                  "campus",
                  "building",
                  "floor",
                  "area"
                ],
                "subtitle_asc": [
                  "area",
                  "floor",
                  "building",
                  "campus"
                ],
                "image": "image",
                "body": [
                  {
                    "label": "Capacity",
                    "icon": "fa-users",
                    "field": "capacity",
                    "field_to_display": ""
                  },
                  {
                    "label": "Standard services",
                    "icon": "fa-check",
                    "field": "standard_services",
                    "field_to_display": "name"
                  },
                  {
                    "label": "Reservable purposes",
                    "icon": "fa-tags",
                    "field": "reservable_purposes",
                    "field_to_display": "name"
                  }
                ]
              },
              "timeSlots": [],
              "buildingSysIds": [
                "4703a4cedb3650106c731dcd13961945",
                "6c0364cedb3650106c731dcd13961927",
                "94e264cedb3650106c731dcd13961919",
                "9e0364cedb3650106c731dcd1396192b"
              ],
              "reservable_views": [
                {
                  "type": "card",
                  "label": "Card view",
                  "iconClass": "fa-th-large",
                  "isDefault": true,
                  "order": "1"
                },
                {
                  "type": "schedule",
                  "label": "Schedule view",
                  "iconClass": "fa-calendar-o",
                  "isDefault": false,
                  "order": "2"
                }
              ],
              "checkin_before_minutes": 30,
              "reservation_paths": [
                {
                  "value": "browse_all",
                  "displayValue": "Browse all",
                  "availableFor": true
                },
                {
                  "value": "browse_favorites",
                  "displayValue": "Browse favorites",
                  "availableFor": false
                },
                {
                  "value": "browse_near_a_person",
                  "displayValue": "Browse near a person",
                  "availableFor": true
                },
                {
                  "value": "browse_by_area",
                  "displayValue": "Browse by area",
                  "availableFor": true
                }
              ],
              "override_approval_policy": "never_required"
            },
            "notification_recipients": null,
            "notification_custom_message": null,
            "opened_by": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "value": "2de07e1887cb89106342b846dabb35fe",
              "displayValue": "Workplace User",
              "display_value": "Workplace User",
              "name": "Workplace User",
              "user_name": "workplace_user",
              "table": "sys_user",
              "avatar": null,
              "initials": "WU",
              "email": "workplace_user@example.com",
              "label": ""
            },
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "value": "2de07e1887cb89106342b846dabb35fe",
              "displayValue": "Workplace User",
              "display_value": "Workplace User",
              "name": "Workplace User",
              "user_name": "workplace_user",
              "table": "sys_user",
              "avatar": null,
              "initials": "WU",
              "email": "workplace_user@example.com",
              "label": ""
            },
            "edit_restriction": {
              "value": "no_restriction",
              "display_value": "No restriction"
            },
            "source": {
              "value": "servicenow",
              "display_value": "Workplace Services"
            },
            "source_reservation_requester": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User",
              "user_name": "workplace_user"
            },
            "source_icon": {
              "classNames": "fa fa-calendar-check-o",
              "tooltip": "Reservation is confirmed",
              "imgSrc": ""
            },
            "shift": null,
            "recurring_pattern": {
              "duration": "3600000",
              "repeats": "daily",
              "options": {
                "count": 3,
                "daysOfWeek": "",
                "every": 1,
                "endDate": "2022-06-13 14:00:00",
                "endDateGdt": {}
              },
              "label": "Repeats daily, 3 times",
              "startDate": "2022-06-11 13:00:00",
              "startDateGdt": "{}",
              "amountOfDates": "3"
            },
            "reservationAcl": {
              "write": {
                "record": true,
                "fields": {
                  "subject": true,
                  "sensitivity": true,
                  "requested_for": true,
                  "number_of_attendees": true,
                  "location": true
                },
                "allFields": true
              },
              "read": true
            }
          }
        ],
        "occurencesTotalCount": "1"
      }
    }
    

    WSD 정기 예약 - PATCH /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}

    지정된 전체 반복 계열 예약 또는 계열 내의 특정 회의 발생을 취소합니다.

    주:
    한 번의 통화에서 여러 회의 항목을 삭제할 수 없습니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/cancel_series/{sys_id}

    기본 URL: /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    sys_id 전체 계열을 취소하려면 반복 상위 예약 기록의 sys_id을 전달합니다.

    특정 계열의 발생을 취소하려면 계열의 발생 sys_id을 전달합니다.

    반복 상위 기록의 열 reservation_subtype은 반복 상위로 설정되어 있습니다. 개별 발생 기록에는 reservation_subtype 필드가 발생으로 설정되어 있습니다.

    발생 기록에서 반복되는 상위 예약의 상세 정보를 얻으려면 발생 기록의 source_reservation 필드 sys_id를 참조하십시오.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    표 8. 쿼리 매개변수
    이름 설명
    cancel_notes 예약을 취소하는 이유입니다.

    데이터 유형: 문자열

    표 9. 요청 본문 매개변수
    이름 설명
    안 함

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 11. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 반복 예약 취소 요청 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
      "failedToCancelOccurrenceReservations": [Array],
      "seriesId": "String",
      "success": Boolean,
      "successCanceledOccurrences": [Array],
      "user_msg": "String"
    }
    result.failedToCancelOccurrenceReservations 취소하지 못한 개별 회의 발생 기록의 sys_ids 목록입니다.

    데이터 유형: 문자열 배열

    result.seriesId 전체 계열이 취소되는 경우 반복되는 상위 항목의 Sys_id 또는 단일 발생이 취소되는 경우 특정 발생의 sys_id입니다.

    데이터 유형: 문자열

    결과.성공 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 성공적으로 취소되었습니다.
    • false: 작업에 실패했습니다.

    데이터 유형: 부울

    result.failedToCancelOccurrenceReservations 성공적으로 취소된 개별 회의 발생 기록의 sys_ids 목록입니다.

    데이터 유형: 문자열 배열

    result.user_msg 요청에 대한 메시지입니다.

    데이터 유형: 문자열

    cURL 요청

    다음 코드 예제에서는 전체 반복 예약을 취소하는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/cancel_series/f64983a347274550003a4587746d43b8" \
    --request PATCH \
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --user "username":"password"

    반환 결과:

    {
      "result": {
        "failedToCancelOccurrenceReservations": [],
        "successCanceledOccurrences": [
          "cb4983a347274550003a4587746d43bd",
          "cf4983a347274550003a4587746d43ba"
        ],
        "user_msg": "Your Recurring reservation has been canceled successfully!",
        "seriesId": "f64983a347274550003a4587746d43b8",
        "success": true
      }
    }

    WSD 반복 예약 - POST /api/sn_wsd_rsv/recurring_reservation/create_series

    매주, 매월 또는 격주처럼 같은 시간에 다른 날짜에 대한 직장 예약을 생성합니다.

    URL 형식

    버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/create_series

    기본 URL: /api/sn_wsd_rsv/recurring_reservation/create_series

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오.

    데이터 유형: 문자열

    표 14. 쿼리 매개변수
    이름 설명
    없음
    표 15. 요청 본문 매개변수
    이름 설명
    recurringPattern 예약의 반복 패턴에 대한 상세 정보입니다.

    데이터 유형: 객체

    "recurringPattern": {
      "duration": Number,
      "label": "String",
      "options": {Object},
      "repeats": "String",
      "startDate": "String"
    }
    recurringPattern.duration 교대조 기반 예약이 아닌 경우 필수입니다.
    예약 가능한 항목을 예약할 시간입니다.

    데이터 유형: 숫자

    단위: 초

    recurringPattern.label 반복 예약에 대한 설명이 포함된 이름입니다.

    데이터 유형: 문자열

    recurringPattern.options 필수
    반복 패턴에 대해 설정된 옵션에 대한 상세 정보입니다.

    데이터 유형: 객체

    "options": {
      "count": Number,
      "daysOfWeek": "String",
      "every": Number,
      "endDate": "String"
    }
    recurringPattern.options.count 교대조 기반 예약이 아닌 경우 필수입니다. 교대조 기반 예약의 경우 무시됩니다.

    패턴을 반복하는 횟수입니다.

    데이터 유형: 숫자

    recurringPattern.options.daysOfWeek 매개변수가 repeats매주로 설정된 경우 필요합니다.

    예약 가능한 요일입니다.

    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats is weekly이고, count5이고, daysOfWeek 245이면 반환 결과에서 합계는 count*daysOfWeek.length(5*3=15)와 같습니다.

    데이터 유형: 문자열

    recurringPattern.options.every 패턴 반복 간격입니다. 예를 들어 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다.
    주:
    이 설정은 매주 반복 간격에는 적용되지 않습니다. 격주 반복 간격으로 속성을 매일로 설정하고 이 값을 14로 설정할 repeats 수 있습니다.

    데이터 유형: 숫자

    기본값: 1

    recurringPattern.options.endDate 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss

    recurringPattern.repeats 교대조 기반 예약이 아닌 경우 필수입니다.

    예약 가능한 반복 패턴입니다.

    유효한 값: (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    주:
    패턴 반복 간격은 속성에 options.every 설정되어 있습니다. 주간 패턴에 대해 유일하게 유효한 반복 간격은 1입니다.

    데이터 유형: 문자열

    recurringPattern.startDate 필수
    반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss

    예약 생성할 반복 예약에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation": {
      "is_private": Boolean,
      "location": "String",
      "reservable_module": "String",
      "shift": "String",
      "subject": "String"
    }
    reservation.is_private 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 누구에게도 표시되지 않습니다.

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

    유효한 값은 다음과 같습니다.
    • true: 예약이 비공개입니다.
    • false: 예약이 비공개가 아닙니다.

    데이터 유형: 부울

    기본값: 시스템 속성에서 개인정보에 대해 설정된 값입니다.

    예약.위치 필수
    예약할 위치의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 위치 [sn_wsd_core_workplace_location]

    reservation.reservable_module 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]

    reservation.shift
    예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다.

    교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]

    reservation.subject 필수
    예약과 관련된 회의의 주제입니다.

    데이터 유형: 문자열

    헤더

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

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

    기본값: application/json

    콘텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 17. 응답 헤더
    머리글 설명
    안 함

    상태 코드

    이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

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

    응답 본문 매개변수

    이름 설명
    결과 다중 예약 생성 또는 업데이트의 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
      "isValid": Boolean,
      "parent": "String",
      "successfulReservations": [Array],
      "unSuccessfulReservations": [Array]
    }
    result.isValid 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 성공적으로 생성되었습니다.
    • false: 작업에 실패했습니다.

    데이터 유형: 부울

    결과.상위 업데이트된 상위 예약의 Sys_id입니다.

    데이터 유형: 문자열

    result.successfulReservations 성공적으로 업데이트된 예약 목록입니다.

    데이터 유형: 객체 배열

    "successfulReservations": [
      {
        "collision": Boolean,
        "end": "String",
        "error": "String",
        "inserted": Boolean,
        "start": "String"
        "sys_id": "String"
      }
    ]
    result.successfulReservations.collision 지정된 시간 동안 예약이 이미 존재하고 현재 예약과 충돌하는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울

    result.successfulReservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    result.successfulReservations.error 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다.

    데이터 유형: 문자열

    result.successfulReservations.inserted 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우.
    가능한 값:
    • true: 성공적으로 삽입되었습니다.
    • false: 작업에 실패했습니다.

    데이터 유형: 부울

    result.successfulReservations.start 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    result.successfulReservations.sys_id 생성된 예약의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    result.unSuccessfulReservations 업데이트하지 못한 예약 목록입니다.

    데이터 유형: 객체 배열

    "unSuccessfulReservations": [
      {
        "collision": Boolean,
        "end": "String",
        "error": "String",
        "inserted": Boolean,
        "start": "String"
        "sys_id": "String"
      }
    ]
    result.unSuccessfulReservations.collision 지정된 시간 동안 예약이 이미 존재하고 현재 예약과 충돌하는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울

    result.unSuccessfulReservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    result.unSuccessfulReservations.error 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다.

    데이터 유형: 문자열

    result.unSuccessfulReservations.inserted 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우.
    가능한 값:
    • true: 성공적으로 삽입되었습니다.
    • false: 작업에 실패했습니다.

    데이터 유형: 부울

    result.unSuccessfulReservations.start 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)

    result.unSuccessfulReservations.sys_id
    예약 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]

    cURL 요청

    다음 코드 예제에서는 2일 연속으로 매일 반복 예약을 만드는 방법을 보여 줍니다.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/create_series" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservation\": {
            \"reservable_module\": \"5db44502dbb650106c731dcd13961937\",
            \"subject\": \"Test-123\",
            \"reservation_purpose\": \"meeting\",
            \"timezone\": \"US/Pacific\",
            \"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
            \"location\": \"6a11a94adb7210106c731dcd1396194e\",
            \"attendees\": \"6816f79cc0a8016401c5a33be04be441\",
            \"is_private\": false
        },
        \"recurringPattern\": {
            \"duration\": 3600000,
            \"repeats\": \"daily\",
            \"options\": {
                \"count\": 2,
                \"daysOfWeek\": \"\",
                \"every\": 1
            },
            \"label\": \"Repeats daily, 2 times\",
            \"startDate\": \"2023-01-12T12:00:00Z\"
        }
    }" \

    반환 결과:

    {
      "result": {
        "isValid": true,
        "parent": "1e5f65ca87586550cfaa99b73cbb3513",
        "successfulReservations": [
          {
            "inserted": true,
            "collision": false,
            "sys_id": "9e5f65ca87586550cfaa99b73cbb3517",
            "error": null,
            "start": "2023-01-13T12:00:00Z",
            "end": "2023-01-13T13:00:00Z"
          }
        ],
        "unSuccessfulReservations": [
          {
            "inserted": true,
            "collision": true,
            "sys_id": "5e5f65ca87586550cfaa99b73cbb3515",
            "error": null,
            "start": "2023-01-12T12:00:00Z",
            "end": "2023-01-12T13:00:00Z"
          }
        ]
      }
    }