性狀

SDM API 中的「特徵」由「欄位」、「指令」和「事件」組成。

所有向 SDM API 發出的呼叫都必須使用下列 端點：
https://smartdevicemanagement.googleapis.com/v1

欄位

欄位是具有常見資料類型的值，例如數字或字串。例如欄位 可能含有目前模式或 Google Nest Thermostat 的環境濕度。

如要查看特徵和欄位，可以使用對所需 API 端點的 GET 呼叫：

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

裝置類型

不應使用 SDM API 傳回的 sdm.devices.types.device-type 推斷或推斷其所指派裝置的功能。無法保證 會讓特定裝置類型保持穩定，因為 SDM 會新增更多功能 也能使用 Google Cloud CLI 或 Compute Engine API請改為使用裝置傳回的特徵。

parentRelations

parentRelations 物件代表目前資源的父項資源 區分結構或房間顯示名稱會對應 customName 資訊特徵 適用於結構父項或 RoomInfo 特性 (適用於 父系物件

指令

指令是與特徵相關聯的要求。例如，變更目前的模式或 Google Nest Thermostat 控制溫度設定點

executeCommand API 呼叫會傳送指令：

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

對指令的回應大多是單純的成功或失敗。請參閱 的個別特性指南 特定指令用法範例

活動

事件由 Google Cloud Pub/Sub 非同步管理，並由 Google Cloud Pub/Sub 管理，在每個主題中 Project ID。

根據預設，當特徵欄位的值有任何變更時，就會傳送事件。這些也可以傳送 回應特定裝置動作或資源指派變更。詳情請見 活動 瞭解詳情

特徵類別

結構

特徵
資訊	sdm.structures.traits.Info 這個特徵屬於結構相關資訊的任何結構。
RoomInfo	sdm.structures.traits.RoomInfo 這個特徵屬於會議室相關資訊的房間。

裝置

特徵
連線能力	sdm.devices.traits.Connectivity 這項特徵適用於所有有連線資訊的裝置。
粉絲	sdm.devices.traits.Fan 凡是能控制風扇的裝置都能使用此特徵。
濕度	sdm.devices.traits.Humidity 凡是搭載感應器且可測量濕度的裝置，都屬於這項特徵。
資訊	sdm.devices.traits.Info 此特徵屬於任何裝置相關資訊。
設定	sdm.devices.traits.Settings 這項特徵屬於任何裝置相關設定資訊。
溫度	sdm.devices.traits.Temperature 凡是搭載感應器的裝置，都能使用這項特徵。

溫度控制器

特徵
ThermostatEco	sdm.devices.traits.ThermostatEco 這項特徵屬於支援 ECO 模式的 THERMOSTAT 裝置類型。
ThermostatHvac	sdm.devices.traits.ThermostatHvac 這項特徵屬於可回報空調詳細資料的 THERMOSTAT 裝置類型。
ThermostatMode	sdm.devices.traits.ThermostatMode 這項特徵屬於支援不同溫度控制器模式的 THERMOSTAT 裝置類型。
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint 這項特徵屬於支援設定目標溫度和溫度範圍的 THERMOSTAT 裝置類型。

相機

特徵
CameraClipPreview	sdm.devices.traits.CameraClipPreview 這個特徵屬於支援下載片段預覽畫面的裝置。
CameraEventImage	sdm.devices.traits.CameraEventImage 這種特徵屬於支援事件產生圖片的裝置。
CameraImage	sdm.devices.traits.CameraImage 這種特徵屬於支援拍照功能的裝置。
CameraLiveStream	sdm.devices.traits.CameraLiveStream 這個特徵屬於支援直播功能的裝置。
CameraMotion	sdm.devices.traits.CameraMotion 此特徵屬於支援動作偵測事件的任何裝置。
CameraPerson	sdm.devices.traits.CameraPerson 此特徵適用於所有支援人員偵測事件的裝置。
CameraSound	sdm.devices.traits.CameraSound 此特徵屬於支援聲響偵測事件的裝置。

門鈴

特徵
DoorbellChime	sdm.devices.traits.DoorbellChime 這個特徵適用於所有支援門鈴鈴聲及相關媒體事件的裝置。