action.devices.QUERY
इस इंटेंट से, डिवाइसों की मौजूदा स्थितियों के बारे में क्वेरी की जाती है. साथ ही, यह भी पता चलता है कि डिवाइस ऑनलाइन है या नहीं.
आपके QUERY
जवाब में सिर्फ़ राज्य की जानकारी होनी चाहिए.
डिवाइस की विशेषताएं और विशेषताएं अपडेट करने पर SYNC
जवाब लागू होता है.
ज़्यादा जानकारी के लिए, क्वेरी करें और एक्ज़ीक्यूट करें देखें.
अनुरोध का फ़ॉर्मैट
फ़ील्ड | टाइप | जानकारी |
---|---|---|
requestId |
String |
ज़रूरी है. अनुरोध का आईडी. |
inputs |
रेंज |
ज़रूरी है. इंटेंट के अनुरोध से मेल खाने वाले इनपुट की सूची. |
[item, ...] |
ऑब्जेक्ट |
इंटेंट अनुरोध से जुड़े टाइप और पेलोड |
intent |
ज़रूरी है. (स्थायी मान: इंटेंट अनुरोध प्रकार. |
|
payload |
ऑब्जेक्ट |
ज़रूरी है. QUERY अनुरोध का पेलोड. |
devices |
रेंज |
ज़रूरी है. टारगेट किए गए डिवाइसों की सूची. |
[item, ...] |
ऑब्जेक्ट |
क्वेरी के लिए डिवाइस को टारगेट किया जाता है. |
id |
String |
ज़रूरी है. सिंक में दिए गए आईडी के मुताबिक डिवाइस आईडी. |
customData |
ऑब्जेक्ट |
अगर बिना जानकारी वाला कस्टम डेटा ऑब्जेक्ट सिंक में दिया गया है, तो उसे यहां भेज दिया जाता है. |
उदाहरण
क्वेरी इंटेंट अनुरोध
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123", "customData": { "fooValue": 74, "barValue": true, "bazValue": "foo" } }, { "id": "456", "customData": { "fooValue": 12, "barValue": false, "bazValue": "bar" } } ] } } ] }
रिस्पॉन्स फ़ॉर्मैट
फ़ील्ड | टाइप | जानकारी |
---|---|---|
requestId |
String |
ज़रूरी है. संबंधित अनुरोध का आईडी. |
payload |
ऑब्जेक्ट |
ज़रूरी है. इंटेंट रिस्पॉन्स पेलोड. |
errorCode |
String |
पुष्टि नहीं होने और डेवलपर सिस्टम के उपलब्ध नहीं होने की वजह से, पूरे लेन-देन के लिए गड़बड़ी का कोड. हर डिवाइस की गड़बड़ियों के लिए, डिवाइस ऑब्जेक्ट में errorCode का इस्तेमाल करें. |
debugString |
String |
ज़्यादा जानकारी वाली गड़बड़ी जो उपयोगकर्ताओं को कभी नहीं दिखाई जाएगी. हालांकि, इस दौरान डेवलपमेंट के दौरान लॉग या इस्तेमाल किया जा सकता है. |
devices |
ऑब्जेक्ट |
ज़रूरी है. डिवाइस का मैप. राज्य डेवलपर प्रॉपर्टी का ऑब्जेक्ट दिखाने के लिए Maps डेवलपर डिवाइस आईडी. |
<string> |
ऑब्जेक्ट |
डिवाइस की स्थिति. |
online |
बूलियन |
ज़रूरी है. इससे पता चलता है कि डिवाइस ऑनलाइन है या नहीं (जिस तक पहुंचा जा सकता है). |
status |
String |
ज़रूरी है. क्वेरी ऑपरेशन का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू:
|
errorCode |
String |
प्रीसेट गड़बड़ी कोड से ज़रूरत के मुताबिक गड़बड़ी की स्थिति को बड़ा करना. यह उपयोगकर्ताओं को पेश की जाने वाली गड़बड़ियों को मैप करेगा. |
उदाहरण
QUERY इंटेंट रिस्पॉन्स
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { "123": { "on": true, "online": true, "status": "SUCCESS" }, "456": { "on": true, "online": true, "status": "SUCCESS", "brightness": 80, "color": { "spectrumRgb": 16711935 } } } } }