REST Resource: resources.buildings
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: Budynek
Publiczny interfejs API: Resources.buildings
Zapis JSON |
{
"buildingId": string,
"buildingName": string,
"description": string,
"coordinates": {
object (BuildingCoordinates )
},
"kind": string,
"etags": string,
"floorNames": [
string
],
"address": {
object (BuildingAddress )
}
} |
Pola |
buildingId |
string
Unikalny identyfikator budynku. Maksymalna długość to 100 znaków.
|
buildingName |
string
Nazwa budynku widoczna dla użytkowników w Kalendarzu. Musi być unikalny dla danego klienta. Na przykład „NYC-CHEL”. Maksymalna długość to 100 znaków.
|
description |
string
Krótki opis budynku. Na przykład „Chelsea Market”.
|
coordinates |
object (BuildingCoordinates )
współrzędne geograficzne środka budynku wyrażone jako szerokość i długość geograficzna w stopniach dziesiętnych;
|
kind |
string
Rodzaj zasobu.
|
etags |
string
ETag zasobu.
|
floorNames[] |
string
Wyświetlane nazwy wszystkich pięter w tym budynku. Piętra powinny być posortowane w kolejności rosnącej, od najniższego do najwyższego. Na przykład ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] Musi zawierać co najmniej 1 wartość.
|
address |
object (BuildingAddress )
Adres pocztowy budynku. Więcej informacji: PostalAddress . Pamiętaj, że wymagany jest tylko 1 wiersz adresu i kod regionu.
|
BuildingCoordinates
Publiczny interfejs API: Resources.buildings
Zapis JSON |
{
"latitude": number,
"longitude": number
} |
Pola |
latitude |
number
Szerokość geograficzna w stopniach dziesiętnych.
|
longitude |
number
Długość geograficzna w stopniach dziesiętnych.
|
BuildingAddress
Publiczny interfejs API: Resources.buildings
Zapis JSON |
{
"regionCode": string,
"languageCode": string,
"postalCode": string,
"administrativeArea": string,
"locality": string,
"sublocality": string,
"addressLines": [
string
]
} |
Pola |
regionCode |
string
Wymagane. Kod regionu CLDR kraju/regionu adresu.
|
languageCode |
string
Opcjonalnie: Kod języka BCP-47 treści tego adresu (jeśli jest znany).
|
postalCode |
string
Opcjonalnie: Kod pocztowy w adresie.
|
administrativeArea |
string
Opcjonalnie: Najwyższy podział administracyjny, który jest używany w przypadku adresów pocztowych w kraju lub regionie.
|
locality |
string
Opcjonalnie: Zwykle odnosi się do części adresu zawierającej nazwę miasta. Przykłady: miasto w USA, miasto w Włoszech, miejscowość w Wielkiej Brytanii. W regionach świata, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, pozostaw pole „Locality” puste i użyj atrybutów „addressLines”.
|
sublocality |
string
Opcjonalnie: Podjednostka adresu.
|
addressLines[] |
string
Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu.
|
Metody |
|
Usuwa budynek. |
|
Pobiera dane budynku. |
|
Wstawia budynek. |
|
Pobiera listę budynków na koncie. |
|
Naprawia budynek. |
|
Zaktualizuj budynek. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-24 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]