REST Resource: resources.buildings
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Xây dựng
API công khai: Resources.buildings
Biểu diễn dưới dạng JSON |
{
"buildingId": string,
"buildingName": string,
"description": string,
"coordinates": {
object (BuildingCoordinates )
},
"kind": string,
"etags": string,
"floorNames": [
string
],
"address": {
object (BuildingAddress )
}
} |
Trường |
buildingId |
string
Giá trị nhận dạng duy nhất của toà nhà. Độ dài tối đa là 100 ký tự.
|
buildingName |
string
Tên toà nhà mà người dùng nhìn thấy trong Lịch. Phải là mã duy nhất của khách hàng. Ví dụ: "NYC-CHEL". Độ dài tối đa là 100 ký tự.
|
description |
string
Nội dung mô tả ngắn gọn về toà nhà. Ví dụ: "Chelsea Market".
|
coordinates |
object (BuildingCoordinates )
Toạ độ địa lý của tâm toà nhà, được biểu thị dưới dạng vĩ độ và kinh độ theo độ thập phân.
|
kind |
string
Loại tài nguyên này.
|
etags |
string
ETag của tài nguyên.
|
floorNames[] |
string
Tên hiển thị của tất cả các tầng trong toà nhà này. Các tầng sẽ được sắp xếp theo thứ tự tăng dần, từ tầng thấp nhất đến tầng cao nhất. Ví dụ: ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] Phải chứa ít nhất một mục nhập.
|
address |
object (BuildingAddress )
Địa chỉ bưu chính của toà nhà. Hãy xem PostalAddress để biết thông tin cụ thể. Xin lưu ý rằng bạn chỉ cần một dòng địa chỉ và mã vùng.
|
BuildingCoordinates
API công khai: Resources.buildings
Biểu diễn dưới dạng JSON |
{
"latitude": number,
"longitude": number
} |
Trường |
latitude |
number
Vĩ độ tính bằng độ thập phân.
|
longitude |
number
Kinh độ theo độ thập phân.
|
BuildingAddress
API công khai: Resources.buildings
Biểu diễn dưới dạng JSON |
{
"regionCode": string,
"languageCode": string,
"postalCode": string,
"administrativeArea": string,
"locality": string,
"sublocality": string,
"addressLines": [
string
]
} |
Trường |
regionCode |
string
Bắt buộc. Mã vùng CLDR của quốc gia/khu vực của địa chỉ.
|
languageCode |
string
Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung trong địa chỉ này (nếu có).
|
postalCode |
string
Không bắt buộc. Mã bưu chính của địa chỉ.
|
administrativeArea |
string
Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực.
|
locality |
string
Không bắt buộc. Thường đề cập đến phần thành phố/thị trấn của địa chỉ. Ví dụ: thành phố ở Hoa Kỳ, comune ở Ý, thị trấn bưu chính ở Vương quốc Anh. Ở những khu vực trên thế giới mà địa phương không được xác định rõ ràng hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng addressLines.
|
sublocality |
string
Không bắt buộc. Khu vực phụ của địa chỉ.
|
addressLines[] |
string
Dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của địa chỉ.
|
Phương thức |
|
Xoá một toà nhà. |
|
Truy xuất một toà nhà. |
|
Chèn một toà nhà. |
|
Truy xuất danh sách các toà nhà cho một tài khoản. |
|
Vá một tòa nhà. |
|
Cập nhật một toà nhà. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]