action.devices.QUERY
यह इंटेंट, डिवाइस की मौजूदा स्थिति के हिसाब से आपके डिवाइस को पूरा करने से जुड़ी क्वेरी करता है. इसमें यह जानकारी भी शामिल होती है कि डिवाइस ऑनलाइन है या नहीं और उसे ऐक्सेस किया जा सकता है या नहीं.
QUERY
के जवाब में सिर्फ़ राज्य की जानकारी दिखनी चाहिए.
डिवाइस के एट्रिब्यूट और विशेषताओं को अपडेट करने का काम,
SYNC
जवाब.
ज़्यादा जानकारी के लिए, क्वेरी और एक्ज़ीक्यूट करना सेक्शन देखें.
अनुरोध का फ़ॉर्मैट
फ़ील्ड | टाइप | ब्यौरा |
---|---|---|
requestId |
String |
ज़रूरी है. अनुरोध का आईडी. |
inputs |
कलेक्शन |
ज़रूरी है. इंटेंट के अनुरोध से मैच करने वाले इनपुट की सूची. |
[item, ...] |
ऑब्जेक्ट |
इंटेंट अनुरोध से जुड़ा टाइप और पेलोड. |
intent |
ज़रूरी है. (कॉन्सटेंट वैल्यू: इंटेंट के अनुरोध का टाइप. |
|
payload |
ऑब्जेक्ट |
ज़रूरी है. QUERY पेलोड का अनुरोध करें. |
devices |
कलेक्शन |
ज़रूरी है. टारगेट किए गए डिवाइसों की सूची. |
[item, ...] |
ऑब्जेक्ट |
क्वेरी करने के लिए डिवाइस लक्ष्य. |
id |
String |
ज़रूरी है. सिंक में दिए गए आईडी के मुताबिक डिवाइस आईडी. |
customData |
ऑब्जेक्ट |
अगर SYNC में ओपेक customData ऑब्जेक्ट दिया जाता है, तो उसे यहां भेजा जाता है. |
उदाहरण
QUERY इंटेंट का अनुरोध
{ "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 |
पुष्टि न होने और डेवलपर सिस्टम के उपलब्ध न होने की वजह से, पूरे लेन-देन के लिए गड़बड़ी का कोड. डिवाइस की अलग-अलग गड़बड़ियों के लिए, डिवाइस ऑब्जेक्ट में गड़बड़ी का कोड इस्तेमाल करें. |
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 } } } } }