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

건물을 업데이트합니다.