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

建築物的專屬 ID。長度上限為 100 個半形字元。

buildingName

string

使用者在 Google 日曆中看到的建築物名稱。此值必須是客戶專屬。例如「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"] 必須包含至少一個項目。

address

object (BuildingAddress)

建築物的郵寄地址。詳情請參閱 PostalAddress。請注意,你只需要填入一行地址和區域代碼。

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

非結構化的地址行,說明地址的低層級項目。

方法

delete

刪除建築物。

get

擷取建築物。

insert

插入建築物。

list

擷取帳戶的建築物清單。

patch

修補建築物。

update

更新建築物。