Google Home के डेवलपर सेंटर में आपका स्वागत है. यहां स्मार्ट होम ऐक्शन बनाने का तरीका सीखा जा सकता है.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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