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
주소의 하위 수준을 설명하는 구조화되지 않은 주소 입력란입니다.
|
메서드 |
|
건물을 삭제합니다. |
|
건물을 검색합니다. |
|
건물을 삽입합니다. |
|
계정의 건물 목록을 가져옵니다. |
|
건물을 패치합니다. |
|
건물을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-24(UTC)
[null,null,["최종 업데이트: 2025-07-24(UTC)"],[],[],null,["# REST Resource: resources.buildings\n\nResource: Building\n------------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"buildingId\": string, \"buildingName\": string, \"description\": string, \"coordinates\": { object (/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingCoordinates) }, \"kind\": string, \"etags\": string, \"floorNames\": [ string ], \"address\": { object (/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingAddress) } } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `buildingId` | `string` Unique identifier for the building. The maximum length is 100 characters. |\n| `buildingName` | `string` The building name as seen by users in Calendar. Must be unique for the customer. For example, \"NYC-CHEL\". The maximum length is 100 characters. |\n| `description` | `string` A brief description of the building. For example, \"Chelsea Market\". |\n| `coordinates` | `object (`[BuildingCoordinates](/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingCoordinates)`)` The geographic coordinates of the center of the building, expressed as latitude and longitude in decimal degrees. |\n| `kind` | `string` Kind of resource this is. |\n| `etags` | `string` ETag of the resource. |\n| `floorNames[]` | `string` The display names for all floors in this building. The floors are expected to be sorted in ascending order, from lowest floor to highest floor. For example, \\[\"B2\", \"B1\", \"L\", \"1\", \"2\", \"2M\", \"3\", \"PH\"\\] Must contain at least one entry. |\n| `address` | `object (`[BuildingAddress](/workspace/admin/directory/reference/rest/v1/resources.buildings#BuildingAddress)`)` The postal address of the building. See [`PostalAddress`](/my-business/reference/rest/v4/PostalAddress) for details. Note that only a single address line and region code are required. |\n\nBuildingCoordinates\n-------------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"latitude\": number, \"longitude\": number } ``` |\n\n| Fields ||\n|-------------|----------------------------------------|\n| `latitude` | `number` Latitude in decimal degrees. |\n| `longitude` | `number` Longitude in decimal degrees. |\n\nBuildingAddress\n---------------\n\nPublic API: Resources.buildings\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"regionCode\": string, \"languageCode\": string, \"postalCode\": string, \"administrativeArea\": string, \"locality\": string, \"sublocality\": string, \"addressLines\": [ string ] } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `regionCode` | `string` Required. CLDR region code of the country/region of the address. |\n| `languageCode` | `string` Optional. BCP-47 language code of the contents of this address (if known). |\n| `postalCode` | `string` Optional. Postal code of the address. |\n| `administrativeArea` | `string` Optional. Highest administrative subdivision which is used for postal addresses of a country or region. |\n| `locality` | `string` Optional. Generally refers to the city/town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave locality empty and use addressLines. |\n| `sublocality` | `string` Optional. Sublocality of the address. |\n| `addressLines[]` | `string` Unstructured address lines describing the lower levels of an address. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-----------------------------------------------|\n| ### [delete](/workspace/admin/directory/reference/rest/v1/resources.buildings/delete) | Deletes a building. |\n| ### [get](/workspace/admin/directory/reference/rest/v1/resources.buildings/get) | Retrieves a building. |\n| ### [insert](/workspace/admin/directory/reference/rest/v1/resources.buildings/insert) | Inserts a building. |\n| ### [list](/workspace/admin/directory/reference/rest/v1/resources.buildings/list) | Retrieves a list of buildings for an account. |\n| ### [patch](/workspace/admin/directory/reference/rest/v1/resources.buildings/patch) | Patches a building. |\n| ### [update](/workspace/admin/directory/reference/rest/v1/resources.buildings/update) | Updates a building. |"]]