विशेषताएं

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

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 ट्रीट के साथ भी मेल खाता है.

निर्देश

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

executeCommand एपीआई कॉल से कोई निर्देश भेजा जाता है:

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

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

इवेंट

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

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

ट्रैट की कैटगरी

बनावट

विशेषताएं
जानकारी	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 यह Trait, डिवाइस से जुड़ी सेटिंग की जानकारी के लिए इस्तेमाल किए जा रहे किसी भी डिवाइस से जुड़ा है.
तापमान	sdm.devices.traits.Temperature यह विशेषता ऐसे किसी भी डिवाइस से जुड़ी है जिसमें तापमान मापने वाला सेंसर होता है.

थर्मोस्टैट

विशेषताएं
ThermostatEco	sdm.devices.traits.ThermostatEco यह Trait, अलग-अलग तरह के उन डिवाइसों से जुड़ा है जो ECO मोड के साथ काम करते हैं.
ThermostatHvac	sdm.devices.traits.ThermostatHvac यह ट्रैट, THERMOSTAT के उन डिवाइस टाइप से जुड़ा है जो एचवीएसी की जानकारी रिपोर्ट कर सकते हैं.
ThermostatMode	sdm.devices.traits.ThermostatMode यह ट्रैट, THERMOSTAT के उन डिवाइस टाइप से जुड़ा है जो अलग-अलग थर्मोस्टैट मोड के साथ काम करते हैं.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint यह ट्रैट, THERMOSTAT के उन डिवाइस टाइप से जुड़ा है जो टारगेट तापमान और तापमान की सीमा सेट करने की सुविधा देते हैं.

कैमरा

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