SDM API'sindeki bir özellik alanları , komutları ve etkinlikleri içerir.
Tüm SDM API çağrıları aşağıdaki uç noktayı kullanmalıdır:https://smartdevicemanagement.googleapis.com/v1
Alanlar
Alanlar, sayı veya dize gibi yaygın veri türlerine sahip değerlerdir. Örneğin, bir alan mevcut modu veya bir Google Nest Termostat'ın ortam nem oranını içerebilir.
Özellikler ve alanlar, istenen API uç noktasına yapılan GET
çağrısıyla görüntülenebilir:
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"
}
]
}
Cihaz türleri
SDM API'si tarafından döndürülen sdm.devices.types.device-type
, atandığı cihazın performansını belirlemek veya tahmin etmek için kullanılmamalıdır. SDM API'sine daha fazla özellik eklendikçe cihaz türünün belirli bir cihaz için sabit kalacağının garantisi yoktur. Bunun yerine, cihaz için döndürülen özellikleri kullanın.
Üst İlişkiler
parentRelations
nesnesi, geçerli kaynağın üst kaynağını (yapı veya oda) temsil eder. Görünen ad, yapı üst öğesi olan cihazlar için
Bilgi özelliği 'ne ya da yapı üst öğesi olan cihazlar için
Oda Bilgisi özelliği {/19/room}'na karşılık gelir{20/oda
Komutlar
Komutlar, bir özellik ile ilişkili isteklerdir. Örneğin, bir Google Nest Thermostat'ta mevcut modu veya istenen sıcaklık ayarını değiştirme.
executeCommand
API çağrısı tarafından bir komut gönderilir:
POST /enterprises/project-id /devices/device-id :executeCommand
{
"command" : "command-name ",
"params" : {
"field " : "value "
}
}
Bir komuta verilen yanıtların çoğu basit bir başarı veya başarısızlıktır. Belirli komut kullanımı örnekleri için özellik rehberlerine göz atın.
Etkinlikler
Etkinlikler eşzamansız olup Google Cloud Pub/Sub tarafından her Project kimliği için tek bir konuda yönetilir.
Bir özellik alanının değerindeki herhangi bir değişiklik için etkinlikler varsayılan olarak gönderilir. Ayrıca, belirli cihaz işlemlerine veya kaynak atamalarındaki değişikliklere yanıt olarak gönderilebilir. Daha fazla bilgi için Etkinlikler sayfasını inceleyin.
Özellik kategorileri
Yapı
Özellikler
Bilgi
sdm.structures.traits.Info
Bu özellik, yapıyla ilgili bilgiler için herhangi bir yapıya aittir.
Oda Bilgileri
sdm.structures.traits.RoomInfo
Bu özellik, odayla ilgili bilgiler için herhangi bir odaya aittir.
Cihaz
Özellikler
Bağlantı
sdm.devices.traits.Connectivity
Bu özellik, bağlantı bilgileri olan tüm cihazlara aittir.
Hayranlar
sdm.devices.traits.Fan
Bu özellik, fanı kontrol edebilecek sistem özelliğine sahip tüm cihazlara aittir.
Nem
sdm.devices.traits.Humidity
Bu özellik, nemi ölçecek bir sensörü olan tüm cihazlara aittir.
Bilgi
sdm.devices.traits.Info
Bu özellik, cihazla ilgili bilgiler için herhangi bir cihaza aittir.
Ayarlar
sdm.devices.traits.Settings
Bu özellik, cihazla ilgili ayar bilgileri için herhangi bir cihaza aittir.
Sıcaklık
sdm.devices.traits.Temperature
Bu özellik, sıcaklığı ölçecek bir sensöre sahip tüm cihazlara aittir.
Termostat
Özellikler
ThermostatEco
sdm.devices.traits.ThermostatEco
Bu özellik, ECO modlarını destekleyen TheTERMOSTAT cihaz türlerine aittir.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Bu özellik, ısıtma, havalandırma ve soğutma ayrıntılarını bildirebilen TheTERMOSTAT cihaz türlerine aittir.
Termostat Modu
sdm.devices.traits.ThermostatMode
Bu özellik, farklı termostat modlarını destekleyen TheRMOSTAT cihaz türlerine aittir.
ThemostmostTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Bu özellik, hedef sıcaklığın ve sıcaklık aralığının ayarlanmasını sağlayan TheTERMOSTAT cihaz türlerine aittir.
Kamera
Özellikler
KameraClipPreview
sdm.devices.traits.CameraClipPreview
Bu özellik, klip önizlemesinin indirilmesini destekleyen tüm cihazlara aittir.
KameraEtkinlik Resmi
sdm.devices.traits.CameraEventImage
Bu özellik, etkinliklerden görüntü oluşturmayı destekleyen tüm cihazlara aittir.
Kamera Görüntüsü
sdm.devices.traits.CameraImage
Bu özellik, resim çekmeyi destekleyen tüm cihazlara aittir.
KameraCanlı Yayın
sdm.devices.traits.CameraLiveStream
Bu özellik, canlı yayını destekleyen tüm cihazlara aittir.
KameraHareketi
sdm.devices.traits.CameraMotion
Bu özellik, hareket algılama etkinliklerini destekleyen tüm cihazlara aittir.
Kamera Kişisi
sdm.devices.traits.CameraPerson
Bu özellik, kişi algılama etkinliklerini destekleyen tüm cihazlara aittir.
Kamera Sesi
sdm.devices.traits.CameraSound
Bu özellik, ses algılama etkinliklerini destekleyen tüm cihazlara aittir.
Kapı zili
Özellikler
Kapı zili
sdm.devices.traits.DoorbellChime
Bu özellik, kapı zili zilini ve ilgili basın etkinliklerini destekleyen tüm cihazlara aittir.