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
カレンダーに表示される建物名。お客様ごとに一意である必要があります。例: NYC-CHEL。最大で 100 文字です。
|
description |
string
建物の簡単な説明。例: 「Chelsea Market」
|
coordinates |
object (BuildingCoordinates )
建物の中心の地理座標(緯度と経度を小数度で表したもの)。
|
kind |
string
リソースの種類。
|
etags |
string
リソースの ETag。
|
floorNames[] |
string
このビル内のすべての階の表示名。階層は、低い階から高い階の順に並べ替える必要があります。例: ["B2", "B1", "L", "1", "2", "2M", "3", "PH"] 少なくとも 1 つのエントリを含む必要があります。
|
address |
object (BuildingAddress )
建物の郵便番号。詳しくは、PostalAddress をご覧ください。住所 1 行目と地域コードのみが必須です。
|
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
省略可。通常は住所の市区町村の部分を指します。たとえば、米国の市、イタリアのコムーネ、英国の郵便町名などがこれに該当します。地域区分が適切に定義されていないところや、この構造にうまく適合しない地域では、locality を空のままにして addressLines を使用してください。
|
sublocality |
string
省略可。住所の市町村部分の下位の区画。
|
addressLines[] |
string
住所の下位部分を記述する非構造化の住所行。
|
メソッド |
|
建物を削除します。 |
|
建物を取得します。 |
|
建物を挿入します。 |
|
アカウントの建物のリストを取得します。 |
|
建物にパッチを適用します。 |
|
建物を更新します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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. |"]]