action.devices.EXECUTE

यह इंटेंट, स्मार्ट होम डिवाइसों पर निर्देश भेजता है.

आपके फ़ुलफ़िलमेंट को हर निर्देश को प्रोसेस करना चाहिए, उसे संबंधित डिवाइस पर भेजना चाहिए, और EXECUTE रिस्पॉन्स में नई स्थिति दिखानी चाहिए.

एक EXECUTE इंटेंट, कई निर्देशों के साथ कई डिवाइसों को टारगेट कर सकता है. उदाहरण के लिए, ट्रिगर किया गया इंटेंट, लाइट के सेट पर चमक और रंग, दोनों को सेट कर सकता है. इसके अलावा, एक से ज़्यादा लाइटों को अलग-अलग रंग में सेट कर सकता है.

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

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

फ़ील्ड	टाइप	ब्यौरा
`requestId`	String	ज़रूरी है. अनुरोध का आईडी.
`inputs`	कलेक्शन	ज़रूरी है. इंटेंट के अनुरोध से मैच करने वाले इनपुट की सूची.
`[item, ...]`	ऑब्जेक्ट	इंटेंट अनुरोध से जुड़ा टाइप और पेलोड.
`intent`		ज़रूरी है. (कॉन्स्टेंट वैल्यू: `"action.devices.EXECUTE"`) इंटेंट के अनुरोध का टाइप.
`payload`	ऑब्जेक्ट	ज़रूरी है. EXECUTE request payload.
`commands`	कलेक्शन	ज़रूरी है. डिवाइस टारगेट और निर्देश के पेयर की सूची.
`[item, ...]`	ऑब्जेक्ट	अटैच किए गए डिवाइस टारगेट पर लागू करने के लिए निर्देशों का सेट.
`devices`	कलेक्शन	ज़रूरी है. टारगेट किए गए डिवाइसों की सूची.
`[item, ...]`	ऑब्जेक्ट	डिवाइस टारगेट, जिसे लागू करना है.
`id`	String	ज़रूरी है. डिवाइस आईडी, जो SYNC में दिए गए आईडी के हिसाब से होता है.
`customData`	ऑब्जेक्ट	अगर SYNC में ओपैक कस्टम डेटा ऑब्जेक्ट दिया जाता है, तो उसे यहां भेजा जाता है.
`execution`	कलेक्शन	ज़रूरी है. टारगेट किए गए डिवाइसों पर लागू करने के लिए निर्देशों की सूची.
`[item, ...]`	ऑब्जेक्ट	डिवाइस के लिए निर्देश.
`command`	String	ज़रूरी है. आम तौर पर, पैरामीटर के साथ इस्तेमाल किया जाने वाला कमांड.
`params`	ऑब्जेक्ट	हर निर्देश के पैरामीटर के साथ अलाइन किया गया.

उदाहरण

इंटेंट के अनुरोध को लागू करना

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123",
                "customData": {
                  "fooValue": 74,
                  "barValue": true,
                  "bazValue": "sheepdip"
                }
              },
              {
                "id": "456",
                "customData": {
                  "fooValue": 36,
                  "barValue": false,
                  "bazValue": "moarsheep"
                }
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

रिस्पॉन्स का फ़ॉर्मैट

फ़ील्ड	टाइप	ब्यौरा
`requestId`	String	ज़रूरी है. उससे जुड़े अनुरोध का आईडी.
`payload`	ऑब्जेक्ट	ज़रूरी है. इंटेंट रिस्पॉन्स पेलोड.
`errorCode`	String	पुष्टि न हो पाने और डेवलपर सिस्टम उपलब्ध न होने की वजह से, पूरे लेन-देन के लिए गड़बड़ी का कोड. डिवाइस से जुड़ी अलग-अलग गड़बड़ियों के लिए, डिवाइस ऑब्जेक्ट में errorCode का इस्तेमाल करें.
`debugString`	String	गड़बड़ी के बारे में ज़्यादा जानकारी देने वाला जवाब, जो उपयोगकर्ताओं को कभी नहीं दिखाया जाएगा. हालांकि, इसे डेवलपमेंट के दौरान लॉग किया जा सकता है या इसका इस्तेमाल किया जा सकता है.
`commands`	कलेक्शन	हर ऑब्जेक्ट में, जवाब की जानकारी वाले एक या एक से ज़्यादा डिवाइस होते हैं. ध्यान दें, हो सकता है कि इन्हें अनुरोध में बताए गए तरीके से ग्रुप न किया गया हो. उदाहरण के लिए, अनुरोध से सात लाइटें चालू हो सकती हैं, जिनमें से तीन लाइटें चालू होंगी और चार लाइटें नहीं होंगी. इसलिए, जवाब में दो ग्रुप होंगे.
`[item, ...]`	ऑब्जेक्ट	डिवाइस पर स्क्रिप्ट लागू करने का नतीजा.
`ids`	कलेक्शन	ज़रूरी है. इस स्थिति से जुड़े डिवाइस आईडी की सूची.
`[item, ...]`	String	डिवाइस आईडी.
`status`	String	ज़रूरी है. 'कार्रवाई को लागू करें' के नतीजे. इस्तेमाल की जा सकने वाली वैल्यू: `SUCCESS` पुष्टि करें कि निर्देश काम कर गया है. `PENDING` कमांड को सूची में जोड़ दिया गया है. हालांकि, उम्मीद है कि यह काम करेगा. `OFFLINE` टारगेट डिवाइस ऑफ़लाइन है या उससे संपर्क नहीं हो पा रहा है. `EXCEPTIONS` किसी निर्देश से जुड़ी समस्या या सूचना है. यह निर्देश पूरा हो सकता है या नहीं. आम तौर पर, यह स्टेटस तब सेट किया जाता है, जब आपको कनेक्ट किए गए किसी दूसरे डिवाइस के बारे में ज़्यादा जानकारी भेजनी हो. `ERROR` टारगेट डिवाइस, निर्देश को पूरा नहीं कर पा रहा है.
`states`	ऑब्जेक्ट	हर ट्रैट स्कीमा रेफ़रंस में बताई गई हर ट्रैट की स्थितियों के साथ अलाइन किया गया. अगर उपलब्ध हो, तो ये स्टेटस, एक्ज़ीक्यूशन के बाद दिखते हैं.
`online`	बूलियन	इससे पता चलता है कि डिवाइस ऑनलाइन है या नहीं.
`errorCode`	String	अगर ज़रूरी हो, तो पहले से तय किए गए गड़बड़ी कोड से गड़बड़ी की स्थिति को बड़ा किया जा सकता है. यह स्थिति, उपयोगकर्ताओं को दिखाई गई गड़बड़ियों से मैप होगी.
`debugString`	String	कमांड-लेवल की ज़्यादा जानकारी वाली गड़बड़ी, जो उपयोगकर्ताओं को कभी नहीं दिखाई जाएगी. हालांकि, इसे डेवलपमेंट के दौरान लॉग किया जा सकता है या इसका इस्तेमाल किया जा सकता है.

उदाहरण

EXECUTE इंटेंट का रिस्पॉन्स

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "on": true,
          "online": true
        }
      },
      {
        "ids": [
          "456"
        ],
        "status": "ERROR",
        "errorCode": "deviceTurnedOff"
      }
    ]
  }
}