स्मार्ट होम ऐक्शन बनाने का तरीका जानने की नई जगह, Google Home डेवलपर सेंटर में आपका स्वागत है. ध्यान दें: Actions कंसोल में कार्रवाइयां बनाना जारी रहेगा.

स्मार्ट होम नेटवर्क कंट्रोल ट्रेल स्कीमा

action.devices.traits.NetworkControl - यह जानकारी उन डिवाइसों पर लागू होती है जो रिपोर्टिंग नेटवर्क डेटा का इस्तेमाल करते हैं और नेटवर्क से जुड़े खास काम करते हैं.

डिवाइस की विशेषताएं

इस सुविधा का इस्तेमाल करने वाले डिवाइस, SYNC की कार्रवाई के तहत, इन एट्रिब्यूट की शिकायत कर सकते हैं. SYNC इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

विशेषताएं Type जानकारी
supportsEnablingGuestNetwork बूलियन

(डिफ़ॉल्ट: false)

अगर मेहमान नेटवर्क की सुविधा चालू की जा सकती है, तो 'सही है' पर सेट करें.

supportsDisablingGuestNetwork बूलियन

(डिफ़ॉल्ट: false)

मेहमान नेटवर्क बंद किए जाने पर, इसे 'सही है' पर सेट करें.

supportsGettingGuestNetworkPassword बूलियन

(डिफ़ॉल्ट: false)

अगर मेहमान नेटवर्क का पासवर्ड GetGuestNetworkPassword निर्देश से मिल सकता है, तो 'सही' पर सेट करें.

networkProfiles रेंज

नेटवर्क के उन नामों को दिखाता है जो उसके साथ काम करते हैं.

[item, ...] String

ऐसे नेटवर्क का नाम जो मिलते-जुलते डिवाइसों के ग्रुप को दिखाता है.

supportsEnablingNetworkProfile बूलियन

(डिफ़ॉल्ट: "false")

अगर नेटवर्क प्रोफ़ाइलें चालू की जा सकती हैं, तो 'सही' पर सेट करें.

supportsDisablingNetworkProfile बूलियन

(डिफ़ॉल्ट: "false")

अगर नेटवर्क प्रोफ़ाइल बंद की जा सकती है, तो 'सही' पर सेट करें.

supportsNetworkDownloadSpeedTest बूलियन

(डिफ़ॉल्ट: false)

डाउनलोड स्पीड टेस्ट होने पर, इसे 'सही है' पर सेट करें.

supportsNetworkUploadSpeedTest बूलियन

(डिफ़ॉल्ट: false)

अगर अपलोड स्पीड टेस्ट किया जा सकता है, तो इसे 'सही है' पर सेट करें.

उदाहरण

मेहमान नेटवर्क, प्रोफ़ाइल, और स्पीड टेस्ट की सुविधा देने वाला नेटवर्क डिवाइस.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "Kids"
  ]
}

डिवाइस की स्थिति

इस सुविधा का इस्तेमाल करने वाली इकाइयां, QUERY की कार्रवाई के तहत, इन स्थितियों की जानकारी दे सकती हैं. QUERY इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य Type जानकारी
networkEnabled बूलियन

मुख्य नेटवर्क चालू है या नहीं.

networkSettings ऑब्जेक्ट

मुख्य नेटवर्क का SSID शामिल है.

ssid String

ज़रूरी है.

नेटवर्क SSID.

guestNetworkEnabled बूलियन

मेहमान नेटवर्क चालू है या नहीं.

guestNetworkSettings ऑब्जेक्ट

इसमें मेहमान नेटवर्क का SSID शामिल होता है.

ssid String

ज़रूरी है.

नेटवर्क SSID.

numConnectedDevices Integer

नेटवर्क से कनेक्ट किए गए डिवाइसों की संख्या.

networkUsageMB Number

एमबी में नेटवर्क का इस्तेमाल (मेगाबाइट). नेटवर्क का इस्तेमाल, मौजूदा बिलिंग अवधि में होता है. यह बिलिंग अवधि के दौरान नेटवर्क के इस्तेमाल की निगरानी के लिए इस्तेमाल किया जा सकता है.

networkUsageLimitMB Number

नेटवर्क की इस्तेमाल की सीमा एमबी (मेगाबाइट) में होती है. नेटवर्क के इस्तेमाल की सीमा, मौजूदा बिलिंग अवधि में है.

networkUsageUnlimited बूलियन

नेटवर्क के इस्तेमाल की कोई सीमा नहीं है या नहीं. अगर डिवाइस की स्थिति networkUsageLimitMB को 'सही है' पर सेट किया जाता है, तो इसे अनदेखा कर दिया जाएगा.

lastNetworkDownloadSpeedTest ऑब्जेक्ट

इसमें, नेटवर्क से डाउनलोड किए जाने की हाल ही की जांच के नतीजे शामिल हैं.

downloadSpeedMbps Number

पिछली नेटवर्क स्पीड टेस्ट की डाउनलोड स्पीड (एमबीपीएस प्रति सेकंड).

unixTimestampSec Integer

पिछली बार नेटवर्क डाउनलोड स्पीड टेस्ट चलाए जाने के बाद, Unix टाइमस्टैंप (Unix Epoch के बाद से सेकंड).

status String

इससे पता चलता है कि क्या पिछला नेटवर्क डाउनलोड स्पीड टेस्ट पूरा हुआ था या वह पूरा नहीं हुआ था.

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

SUCCESS
FAILURE
lastNetworkUploadSpeedTest ऑब्जेक्ट

इसमें हाल ही में अपलोड किए गए नेटवर्क की स्पीड की जांच के नतीजे शामिल हैं.

uploadSpeedMbps Number

पिछली नेटवर्क स्पीड टेस्ट की अपलोड स्पीड (एमबीपीएस प्रति सेकंड)

unixTimestampSec Integer

पिछली बार अपलोड की गई स्पीड की जांच करते समय, Unix टाइमस्टैंप (Unix Epoch के बाद से सेकंड) की संख्या.

status String

इससे पता चलता है कि पिछला नेटवर्क अपलोड स्पीड टेस्ट सफल रहा या नहीं.

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

SUCCESS
FAILURE
networkSpeedTestInProgress बूलियन

(डिफ़ॉल्ट: false)

स्पीड टेस्ट किया जा रहा है या नहीं.

networkProfilesState ऑब्जेक्ट

नेटवर्क प्रोफ़ाइल की स्थिति. इस टॉप लेवल ऑब्जेक्ट में, कुंजी की वैल्यू के ऐसे जोड़े शामिल होने चाहिए जिनमें कुंजी, networkProfiles एट्रिब्यूट में शामिल नेटवर्क प्रोफ़ाइलों में से किसी एक का नाम हो. वहीं, वैल्यू उस प्रोफ़ाइल से जुड़ी स्थिति के तौर पर होनी चाहिए.

<string> ऑब्जेक्ट

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

enabled बूलियन

नेटवर्क प्रोफ़ाइल की चालू/बंद होने की मौजूदा स्थिति.

उदाहरण

चालू नेटवर्क वाला डिवाइस.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8
}

चालू नेटवर्क और स्पीड टेस्ट के नतीजों वाला डिवाइस.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "lastNetworkDownloadSpeedTest": {
    "downloadSpeedMbps": 159.8,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  },
  "lastNetworkUploadSpeedTest": {
    "uploadSpeedMbps": 64.1,
    "unixTimestampSec": 1563215576,
    "status": "SUCCESS"
  }
}

चालू नेटवर्क और स्पीड टेस्ट वाला डिवाइस.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "guestNetworkSettings": {
    "ssid": "home-network-123-guest"
  },
  "numConnectedDevices": 4,
  "networkUsageMB": 100.8,
  "networkSpeedTestInProgress": true
}

"बच्चों" के नेटवर्क प्रोफ़ाइल वाला डिवाइस बंद किया गया.

{
  "networkEnabled": true,
  "networkSettings": {
    "ssid": "home-network-123"
  },
  "networkProfilesState": {
    "parents": {
      "enabled": true
    },
    "kids": {
      "enabled": false
    }
  }
}

डिवाइस के निर्देश

इस सुविधा का इस्तेमाल करने वाले डिवाइस, EXECUTE की कार्रवाई के तहत, इन निर्देशों का पालन कर सकते हैं. EXECUTE इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

action.devices.commands.EnableDisableGuestNetwork

मेहमान नेटवर्क को चालू या बंद करें. पिन के साथ दूसरे उपयोगकर्ता की पुष्टि का इस्तेमाल किया जाना चाहिए. अगर इन निर्देशों की मदद से सुरक्षा से जुड़े दूसरे डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता की होम सुरक्षा पर असर पड़ सकता है.

इस निर्देश के लिए इन एट्रिब्यूट की ज़रूरत होती है:
{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true
}

पैरामीटर

पैरामीटर Type जानकारी
enable बूलियन

ज़रूरी है.

मेहमान नेटवर्क को चालू करने के लिए सही, मेहमान नेटवर्क को बंद करने के लिए गलत.

उदाहरण

मेहमान नेटवर्क चालू करें.

{
  "command": "action.devices.commands.EnableDisableGuestNetwork",
  "params": {
    "enable": true
  }
}

action.devices.commands.EnableDisableNetworkProfile

नेटवर्क प्रोफ़ाइल को चालू या बंद करें. पिन के साथ दूसरे उपयोगकर्ता की पुष्टि का इस्तेमाल किया जाना चाहिए. अगर इन निर्देशों की मदद से सुरक्षा से जुड़े दूसरे डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता की होम सुरक्षा पर असर पड़ सकता है.

इस निर्देश के लिए इन एट्रिब्यूट की ज़रूरत होती है:
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

पैरामीटर

पैरामीटर Type जानकारी
profile String

ज़रूरी है.

networkProfiles एट्रिब्यूट से बना प्रोफ़ाइल नाम.

enable बूलियन

ज़रूरी है.

प्रोफ़ाइल चालू करने के लिए सही, प्रोफ़ाइल बंद करने के लिए गलत.

उदाहरण

बच्चों के लिए इंटरनेट बंद करें.

{
  "command": "action.devices.commands.EnableDisableNetworkProfile",
  "params": {
    "profile": "Kids",
    "enable": false
  }
}

दी गई नेटवर्क प्रोफ़ाइल को नियंत्रित करते समय कोई गड़बड़ी हुई.

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

networkProfileNotRecognized

action.devices.commands.GetGuestNetworkPassword

मेहमान नेटवर्क का पासवर्ड पाएं. पिन के साथ दूसरे उपयोगकर्ता की पुष्टि का इस्तेमाल किया जाना चाहिए. अगर इन निर्देशों की मदद से सुरक्षा से जुड़े दूसरे डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता की होम सुरक्षा पर असर पड़ सकता है.

इस निर्देश के लिए इन एट्रिब्यूट की ज़रूरत होती है:
{
  "supportsGettingGuestNetworkPassword": true
}

पैरामीटर

पैरामीटर Type जानकारी

कोई प्रॉपर्टी नहीं

उदाहरण

मेहमान का वाई-फ़ाई पासवर्ड दिखाओ.

{
  "command": "action.devices.commands.GetGuestNetworkPassword",
  "params": {}
}

नतीजे

नतीजे Type जानकारी
guestNetworkPassword String

ज़रूरी है.

मेहमान नेटवर्क का पासवर्ड.

उदाहरण

मेहमान का वाई-फ़ाई पासवर्ड दिखाओ.

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

नेटवर्क की डाउनलोड और अपलोड करने की स्पीड की जांच करें.

इस निर्देश के लिए इन एट्रिब्यूट की ज़रूरत होती है:
{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

पैरामीटर

पैरामीटर Type जानकारी
testDownloadSpeed बूलियन

ज़रूरी है.

इससे पता चलता है कि डाउनलोड की स्पीड की जांच करनी है या नहीं.

testUploadSpeed बूलियन

ज़रूरी है.

इससे यह पता चलता है कि अपलोड की स्पीड की जांच करनी है या नहीं.

followUpToken String

ज़रूरी है.

फ़ॉलो-अप जवाब के लिए Google की ओर से दिया गया टोकन.

उदाहरण

वाई-फ़ाई की स्पीड क्या है?

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

स्पीड टेस्ट का अनुरोध करते समय कोई गड़बड़ी हुई.

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

networkSpeedTestInProgress

फ़ॉलो-अप जवाब

इस सुविधा का इस्तेमाल करने वाले डिवाइस, EXECUTE कार्रवाई के दौरान फ़ॉलो-अप रिस्पॉन्स पेलोड दिखा सकते हैं. फ़ॉलो-अप रिस्पॉन्स लागू करने के बारे में ज़्यादा जानने के लिए, स्मार्ट होम ऐक्शन से जुड़ी सूचनाएं देखें.

पेलोड में इनमें से कोई एक चीज़ होती है:

सफल: networkDownloadspeedMbps

फ़ील्ड Type जानकारी
followUpToken String

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.

status String

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkDownloadSpeedMbps Number

ज़रूरी है.

नेटवर्क डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

सफल: networkUploadspeedMbps

फ़ील्ड Type जानकारी
followUpToken String

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.

status String

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkUploadSpeedMbps Number

ज़रूरी है.

नेटवर्क अपलोड की स्पीड, मेगाबिट प्रति सेकंड के हिसाब से मापी गई है.

सफल: networkDownloadspeedMbps और networkUploadSpeedMbps

फ़ील्ड Type जानकारी
followUpToken String

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.

status String

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkDownloadSpeedMbps Number

ज़रूरी है.

नेटवर्क डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

networkUploadSpeedMbps Number

ज़रूरी है.

नेटवर्क अपलोड की स्पीड, मेगाबिट प्रति सेकंड के हिसाब से मापी गई है.

पूरा नहीं हो सका

फ़ील्ड Type जानकारी
followUpToken String

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.

status String

ज़रूरी है.

अनुरोध का नतीजा.

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

FAILURE
errorCode String

ज़रूरी है.

इस एट्रिब्यूट के लिए कोई भी गड़बड़ी कोड हो सकता है, उदाहरण के लिए transientError.

उदाहरण

वाई-फ़ाई की रफ़्तार क्या है? (फ़ॉलो-अप रिस्पॉन्स)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "SUCCESS",
      "networkDownloadSpeedMbps": 23.3,
      "networkUploadSpeedMbps": 10.2,
      "followUpToken": "1234"
    }
  }
}

वाई-फ़ाई की रफ़्तार क्या है? (बाद में असफल होने पर फ़ॉलो-अप जवाब)

{
  "NetworkControl": {
    "priority": 0,
    "followUpResponse": {
      "status": "FAILURE",
      "errorCode": "transientError",
      "followUpToken": "1234"
    }
  }
}

डिवाइस में गड़बड़ी

गड़बड़ियों और अपवादों की पूरी सूची देखें.

दी गई नेटवर्क प्रोफ़ाइल को नियंत्रित करते समय कोई गड़बड़ी हुई.

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

networkProfileNotRecognized

स्पीड टेस्ट का अनुरोध करते समय कोई गड़बड़ी हुई.

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

networkSpeedTestInProgress