विशेषताएं

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

parentRelations

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

निर्देश

निर्देश, किसी खास विशेषता से जुड़े अनुरोध होते हैं. उदाहरण के लिए, 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 यह ट्रैट किसी भी ऐसे डिवाइस से जुड़ा होता है जिसमें कनेक्टिविटी की जानकारी होती है.
फ़ैन	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 यह ट्रैट, 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 यह ट्रैट किसी भी ऐसे डिवाइस से जुड़ा होता है जिस पर दरवाज़े की घंटी बजने की सुविधा और उससे जुड़े प्रेस इवेंट काम करते हैं.