REST Resource: resources.buildings

리소스: 빌드

공개 API: Resources.buildings

JSON 표현 
{
  "buildingId": string,
  "buildingName": string,
  "description": string,
  "coordinates": {
    object (BuildingCoordinates)
  },
  "kind": string,
  "etags": string,
  "floorNames": [
    string
  ],
  "address": {
    object (BuildingAddress)
  }
}
필드
buildingId

string

건물의 고유 식별자입니다. 최대 길이는 100자입니다.
buildingName

string

Calendar에서 사용자에게 표시되는 건물 이름입니다. 고객별로 고유해야 합니다. 예: 'NYC-CHEL' 최대 길이는 100자입니다.
description

string

건물에 대한 간략한 설명입니다. 예: '첼시 마켓'
coordinates

object (BuildingCoordinates)

건물 중심의 지리 좌표로, 위도와 경도로 십진법 각도로 표현됩니다.
kind

string

리소스의 유형입니다.
etags

string

리소스의 ETag입니다.
floorNames[]

string

이 건물의 모든 층에 대한 표시 이름입니다. 층수는 가장 낮은 층에서 가장 높은 층까지 오름차순으로 정렬되어야 합니다. 예: ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] 에는 하나 이상의 항목이 포함되어야 합니다.
address

object (BuildingAddress)

건물의 우편 주소입니다. 자세한 내용은 PostalAddress를 참고하세요. 하나의 주소 입력란과 지역 코드만 필요합니다.

BuildingCoordinates

공개 API: Resources.buildings

JSON 표현 
{
  "latitude": number,
  "longitude": number
}
필드
latitude

number

십진수 도 단위의 위도입니다.
longitude

number

경도(십진수 도)입니다.

BuildingAddress

공개 API: Resources.buildings

JSON 표현 
{
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ]
}
필드
regionCode

string

필수 항목입니다. 주소의 국가/지역에 해당하는 CLDR 지역 코드입니다.
languageCode

string

선택사항입니다. 이 주소 콘텐츠의 BCP-47 언어 코드입니다 (알려진 경우).
postalCode

string

선택사항입니다. 주소의 우편번호입니다.
administrativeArea

string

선택사항입니다. 국가 또는 지역의 우편 주소에 사용되는 최상위 행정 구역 단위입니다.
locality

string

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 도시, IT 코뮌, 영국 우체국 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다.
sublocality

string

선택사항입니다. 주소의 하위 지역입니다.
addressLines[]

string

주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.

방법

delete

 건물을 삭제합니다.

get

 건물을 검색합니다.

insert

 건물을 삽입합니다.

list

 계정의 건물 목록을 검색합니다.

patch

 건물에 패치를 적용합니다.

update

 건물을 업데이트합니다.