REST Resource: resources.buildings
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: Building
API publique: Resources.buildings
Représentation JSON |
{
"buildingId": string,
"buildingName": string,
"description": string,
"coordinates": {
object (BuildingCoordinates )
},
"kind": string,
"etags": string,
"floorNames": [
string
],
"address": {
object (BuildingAddress )
}
} |
Champs |
buildingId |
string
Identifiant unique du bâtiment. La longueur ne doit pas dépasser 100 caractères.
|
buildingName |
string
Nom du bâtiment tel qu'il apparaît dans Agenda. Doit être unique pour le client. Par exemple, "NYC-CHEL". La longueur ne doit pas dépasser 100 caractères.
|
description |
string
Brève description du bâtiment. (par exemple, "Chelsea Market").
|
coordinates |
object (BuildingCoordinates )
Coordonnées géographiques du centre du bâtiment, exprimées en latitude et longitude en degrés décimaux.
|
kind |
string
Type de ressource
|
etags |
string
ETag de la ressource.
|
floorNames[] |
string
Noms à afficher pour tous les étages de ce bâtiment. Les étages doivent être triés par ordre croissant, du plus bas au plus haut. Par exemple, ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] doit contenir au moins une entrée.
|
address |
object (BuildingAddress )
Adresse postale du bâtiment. Voir PostalAddress pour plus d'informations. Notez qu'une seule ligne d'adresse et un seul code de région sont obligatoires.
|
BuildingCoordinates
API publique: Resources.buildings
Représentation JSON |
{
"latitude": number,
"longitude": number
} |
Champs |
latitude |
number
Latitude en degrés décimaux.
|
longitude |
number
Longitude en degrés décimaux.
|
BuildingAddress
API publique: Resources.buildings
Représentation JSON |
{
"regionCode": string,
"languageCode": string,
"postalCode": string,
"administrativeArea": string,
"locality": string,
"sublocality": string,
"addressLines": [
string
]
} |
Champs |
regionCode |
string
Obligatoire. Code pays/région CLDR de l'adresse.
|
languageCode |
string
Facultatif. Code de langue BCP-47 du contenu de cette adresse (s'il est connu).
|
postalCode |
string
Facultatif. Code postal de l'adresse.
|
administrativeArea |
string
Facultatif. Plus haute subdivision administrative utilisée pour les adresses postales d'un pays ou d'une région.
|
locality |
string
Facultatif. Fait généralement référence à la ville de l'adresse. Exemples : une "city" aux États-Unis, une "comune" en Italie, une "post town" au Royaume-Uni. Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez le champ de localité vide et utilisez addressLines.
|
sublocality |
string
Facultatif. Sous-localité de l'adresse.
|
addressLines[] |
string
Lignes d'adresse non structurées décrivant les niveaux inférieurs d'une adresse.
|
Méthodes |
|
Supprime un bâtiment. |
|
Récupère un bâtiment. |
|
Insère un bâtiment. |
|
Récupère la liste des bâtiments d'un compte. |
|
Applique un correctif à un bâtiment. |
|
Met à jour un bâtiment. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/24 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]