action.devices.QUERY

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

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

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

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

फ़ील्ड टाइप जानकारी
requestId String

ज़रूरी है.

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

inputs रेंज

ज़रूरी है.

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

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

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

intent

ज़रूरी है.

(स्थायी मान: "action.devices.QUERY")

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

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

ज़रूरी है.

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

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

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
        }
      }
    }
  }
}