विशेषताएं

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 यह ट्रेट, दरवाज़े की घंटी की आवाज़ और उससे जुड़े प्रेस इवेंट की सुविधा वाले किसी भी डिवाइस के साथ काम करती है.