विशेषताएं

SDM API में मौजूद ट्रेट में फ़ील्ड, कमांड, और इवेंट शामिल होते हैं.

SDM API को किए जाने वाले सभी कॉल में, इस एंडपॉइंट का इस्तेमाल किया जाना चाहिए:
https://smartdevicemanagement.googleapis.com/v1

फ़ील्ड

फ़ील्ड, सामान्य डेटा टाइप वाली वैल्यू होती हैं. जैसे, कोई संख्या या स्ट्रिंग. उदाहरण के लिए, किसी फ़ील्ड में Google Nest Thermostat का मौजूदा मोड या कमरे में मौजूद नमी की जानकारी हो सकती है.

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"
    }
  ]
}

Device types

एसडीएम एपीआई से मिले sdm.devices.types.device-type का इस्तेमाल, उस डिवाइस के काम करने के तरीके का पता लगाने के लिए नहीं किया जाना चाहिए जिसे यह असाइन किया गया है. इस बात की कोई गारंटी नहीं है कि किसी डिवाइस के लिए डिवाइस टाइप स्थिर रहेगा, क्योंकि SDM API में ज़्यादा सुविधाएं जोड़ी जाती हैं. इसके बजाय, डिवाइस के लिए दिखाए गए ट्रेट का इस्तेमाल करें.

parentRelations

parentRelations ऑब्जेक्ट, मौजूदा संसाधन के पैरंट संसाधन को दिखाता है. यह स्ट्रक्चर या कमरा हो सकता है. डिसप्ले नेम, स्ट्रक्चर पैरंट वाले डिवाइसों के लिएInfo trait या रूम पैरंट वाले डिवाइसों के लिएRoomInfo trait से मेल खाता है.

निर्देश

कमांड, किसी ट्रेट से जुड़े अनुरोध होते हैं. उदाहरण के लिए, Google Nest Thermostat का मौजूदा मोड या तापमान सेटपॉइंट बदलना.

executeCommand एपीआई कॉल से एक कमांड भेजी जाती है:

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

किसी निर्देश के जवाब में, ज़्यादातर मामलों में यह बताया जाता है कि निर्देश पूरा हुआ या नहीं. कमांड के इस्तेमाल के उदाहरणों के लिए, अलग-अलग ट्रेट की गाइड देखें.

इवेंट

इवेंट एसिंक्रोनस होते हैं. इन्हें Google Cloud Pub/Sub मैनेज करता है. हर Project आईडी के लिए एक विषय होता है.

किसी भी ट्रेट फ़ील्ड की वैल्यू में बदलाव होने पर, इवेंट डिफ़ॉल्ट रूप से भेजे जाते हैं. इन्हें डिवाइस से जुड़ी खास कार्रवाइयों या संसाधन असाइनमेंट में हुए बदलावों के जवाब में भी भेजा जा सकता है. ज़्यादा जानकारी के लिए, इवेंट देखें.

ट्रेट कैटगरी

बनावट

विशेषताएं
जानकारी	sdm.structures.traits.Info यह ट्रेट, स्ट्रक्चर से जुड़ी जानकारी के लिए किसी भी स्ट्रक्चर से जुड़ी होती है.
RoomInfo	sdm.structures.traits.RoomInfo यह लक्षण, कमरे से जुड़ी जानकारी के लिए किसी भी कमरे से जुड़ा होता है.

डिवाइस

विशेषताएं
कनेक्टिविटी	sdm.devices.traits.Connectivity यह ट्रेट, कनेक्टिविटी की जानकारी देने वाले किसी भी डिवाइस से जुड़ी होती है.
Fan	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 यह ट्रेट, थर्मोस्टैट के उन डिवाइस टाइप से जुड़ी है जिनमें ईको मोड की सुविधा काम करती है.
ThermostatHvac	sdm.devices.traits.ThermostatHvac यह ट्रेट, थर्मोस्टैट डिवाइस टाइप से जुड़ी है. यह एचवीएसी की जानकारी दे सकती है.
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 यह ट्रेट, ऐसे किसी भी डिवाइस से जुड़ी होती है जिस पर डोरबेल की आवाज़ सुनाई देती है और उससे जुड़े प्रेस इवेंट होते हैं.