REST Resource: resources.buildings
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: Bina
Herkese açık API: Resources.buildings
JSON gösterimi |
{
"buildingId": string,
"buildingName": string,
"description": string,
"coordinates": {
object (BuildingCoordinates )
},
"kind": string,
"etags": string,
"floorNames": [
string
],
"address": {
object (BuildingAddress )
}
} |
Alanlar |
buildingId |
string
Binanın benzersiz tanımlayıcısı. Maksimum uzunluk 100 karakterdir.
|
buildingName |
string
Kullanıcıların Takvim'de gördüğü bina adı. Müşteri için benzersiz olmalıdır. Örneğin, "NYC-CHEL". Maksimum uzunluk 100 karakterdir.
|
description |
string
Binanın kısa açıklaması. Örneğin, "Chelsea Market".
|
coordinates |
object (BuildingCoordinates )
Binanın merkezinin coğrafi koordinatları (ondalık derece cinsinden enlem ve boylam olarak ifade edilir).
|
kind |
string
Bu kaynağın türü.
|
etags |
string
Kaynağın ETag'i.
|
floorNames[] |
string
Bu binanın tüm katlarının görünen adları. Katların en düşük kattan en yüksek kata doğru artan düzende sıralanması gerekir. Örneğin, ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] En az bir giriş içermelidir.
|
address |
object (BuildingAddress )
Binanın posta adresi. Ayrıntılar için PostalAddress öğesine bakın. Yalnızca tek bir adres satırı ve bölge kodu gerektiğini unutmayın.
|
BuildingCoordinates
Herkese açık API: Resources.buildings
JSON gösterimi |
{
"latitude": number,
"longitude": number
} |
Alanlar |
latitude |
number
Ondalık derece cinsinden enlem.
|
longitude |
number
Ondalık derece cinsinden boylam.
|
BuildingAddress
Herkese açık API: Resources.buildings
JSON gösterimi |
{
"regionCode": string,
"languageCode": string,
"postalCode": string,
"administrativeArea": string,
"locality": string,
"sublocality": string,
"addressLines": [
string
]
} |
Alanlar |
regionCode |
string
Zorunlu. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu.
|
languageCode |
string
İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa).
|
postalCode |
string
İsteğe bağlı. Adresin posta kodu.
|
administrativeArea |
string
İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim.
|
locality |
string
İsteğe bağlı. Genellikle adresin şehir/kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünya bölgelerinde locality alanını boş bırakın ve addressLines alanını kullanın.
|
sublocality |
string
İsteğe bağlı. Adresin alt mahallesi.
|
addressLines[] |
string
Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.
|
Yöntemler |
|
Bir binayı siler. |
|
Bir binayı alır. |
|
Bina ekler. |
|
Bir hesaptaki binaların listesini alır. |
|
Bir binayı onarır. |
|
Bir binayı günceller. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-24 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]