विशेषताएं

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

एसडीएम एपीआई को किए जाने वाले सभी कॉल के लिए, इनका इस्तेमाल किया जाना चाहिए एंडपॉइंट:
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 का इस्तेमाल नहीं किया जाना चाहिए डिवाइस को असाइन किए गए असल डिवाइस की सुविधाओं का पता लगाने या उसका अनुमान लगाने के लिए. इसकी कोई गारंटी नहीं है कि एसडीएम में ज़्यादा सुविधाएं जोड़ने पर, किसी खास डिवाइस के लिए एक खास तरह का डिवाइस ठीक से काम करता रहेगा एपीआई. इसके बजाय, डिवाइस के लिए दिखाए गए Trait का इस्तेमाल करें.

parentRelations

parentRelations ऑब्जेक्ट, मौजूदा संसाधन का पैरंट संसाधन दिखाता है, इमारत या कमरा हो सकता है. डिसप्ले नेम, इसके customName फ़ील्ड के मुताबिक है जानकारी की विशेषता पैरंट स्ट्रक्चर वाले डिवाइसों या RoomInfo Trait उन डिवाइसों के लिए जिनमें रूम पैरंट.

निर्देश

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

थर्मोस्टैट

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

कैमरा

विशेषताएं
CameraClipPreview	sdm.devices.traits.CameraClipPreview यह Trait ऐसे किसी भी डिवाइस से जुड़ा है जो क्लिप की झलक को डाउनलोड करने की सुविधा देता है.
CameraEventImage	sdm.devices.traits.CameraEventImage यह विशेषता ऐसे किसी भी डिवाइस से जुड़ी है जो इवेंट से इमेज जनरेट करने की सुविधा देता है.
CameraImage	sdm.devices.traits.CameraImage यह विशेषता ऐसे किसी भी डिवाइस से संबंधित है जो चित्र लेने का समर्थन करता है.
CameraLiveStream	sdm.devices.traits.CameraLiveStream यह Trait ऐसे किसी भी डिवाइस से जुड़ा है जिसमें लाइव स्ट्रीमिंग की सुविधा काम करती है.
CameraMotion	sdm.devices.traits.CameraMotion यह विशेषता ऐसे किसी भी डिवाइस से जुड़ी है जो गति का पता लगाने वाले इवेंट की सुविधा देता है.
CameraPerson	sdm.devices.traits.CameraPerson यह विशेषता ऐसे किसी भी डिवाइस से जुड़ी है जो किसी व्यक्ति की पहचान करने वाले इवेंट की सुविधा देता है.
CameraSound	sdm.devices.traits.CameraSound यह Trait ऐसे किसी भी डिवाइस से जुड़ा है जो आवाज़ का पता लगाने वाले इवेंट की सुविधा देता है.

दरवाज़े की घंटी

विशेषताएं
DoorbellChime	sdm.devices.traits.DoorbellChime यह विशेषता ऐसे किसी भी डिवाइस पर लागू होती है जिसमें डोरबेल की घंटी बजने और उससे जुड़े प्रेस इवेंट की सुविधा हो.