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

선택사항입니다. 일반적으로 주소의 시/군/구 부분을 나타냅니다. 예: 미국 시, 이탈리아 코무네, 영국 포스트타운. 지역이 잘 정의되지 않거나 이 구조에 잘 맞지 않는 경우 지역을 비워 두고 addressLines를 사용합니다.

sublocality

string

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

addressLines[]

string

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

메서드

delete

건물을 삭제합니다.

get

건물을 검색합니다.

insert

건물을 삽입합니다.

list

계정의 건물 목록을 가져옵니다.

patch

건물을 패치합니다.

update

건물을 업데이트합니다.