action.devices.QUERY

यह इंटेंट, डिवाइस की मौजूदा स्थिति के हिसाब से आपके डिवाइस को पूरा करने से जुड़ी क्वेरी करता है. इसमें यह जानकारी भी शामिल होती है कि डिवाइस ऑनलाइन है या नहीं और उसे ऐक्सेस किया जा सकता है या नहीं.

QUERY के जवाब में सिर्फ़ राज्य की जानकारी दिखनी चाहिए. डिवाइस के एट्रिब्यूट और विशेषताओं को अपडेट करने का काम, SYNC जवाब.

ज़्यादा जानकारी के लिए, क्वेरी और एक्ज़ीक्यूट करना सेक्शन देखें.

अनुरोध का फ़ॉर्मैट

फ़ील्ड टाइप ब्यौरा
requestId String

ज़रूरी है.

अनुरोध का आईडी.

inputs कलेक्शन

ज़रूरी है.

इंटेंट के अनुरोध से मैच करने वाले इनपुट की सूची.

[item, ...] ऑब्जेक्ट

इंटेंट अनुरोध से जुड़ा टाइप और पेलोड.

intent

ज़रूरी है.

(कॉन्सटेंट वैल्यू: "action.devices.QUERY")

इंटेंट के अनुरोध का टाइप.

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

ज़रूरी है.

क्वेरी ऑपरेशन का नतीजा.

इस्तेमाल की जा सकने वाली वैल्यू:

SUCCESS
पुष्टि करें कि क्वेरी पूरी हो गई है.
OFFLINE
टारगेट डिवाइस ऑफ़लाइन है या ऐक्सेस नहीं किया जा सकता.
EXCEPTIONS
किसी क्वेरी से जुड़ी कोई समस्या या सूचना है. क्वेरी सफल या असफल हो सकती है. आम तौर पर, यह स्टेटस तब सेट किया जाता है, जब आपको कनेक्ट किए गए किसी दूसरे डिवाइस के बारे में ज़्यादा जानकारी भेजनी होती है.
ERROR
टारगेट किए गए डिवाइस पर क्वेरी नहीं की जा सकी.
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
        }
      }
    }
  }
}