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

리소스의 eETag입니다.

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

건물을 업데이트합니다.