इस एपीआई का इस्तेमाल करें

आपके पास ऐक्सेस टोकन होता है और डिवाइस की सूची का शुरुआती कॉल किया जाता है. अब एसडीएम एपीआई का इस्तेमाल करके, अपने डिवाइस को ऐक्सेस और कंट्रोल किया जा सकता है.

स्ट्रक्चर और डिवाइसों की सूची बनाएं

structures एंडपॉइंट को आसान से GET कॉल करने के लिए curl का इस्तेमाल करें:

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/structures' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

सफल कॉल पर, आपके Device Access प्रोजेक्ट से जुड़े खातों के स्ट्रक्चर की सूची दिखती है:

{
  "structures": [
    {
      "name": "enterprises/project-id/structures/structure-id",
      "traits": {
        "sdm.structures.traits.Info": {
          "customName": "structure-name"
        }
      }
    }
  ]
}

अगर आपने अब तक ऐसा नहीं किया है, तो डिवाइसों की सूची पाने के लिए devices एंडपॉइंट पर एक GET कॉल करें:

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

सफल कॉल पर, आपके Device Accessप्रोजेक्ट से लिंक किए गए डिवाइसों की सूची दिखती है. हर डिवाइस में, चुने गए लक्षणों की अपनी एक खास सूची होती है:

{
  "devices": [
    {
      "name": "enterprises/project-id/devices/device-id",
      "type": "sdm.devices.types.device-type",
      "traits": { ... },
      "parentRelations": [
        {
          "parent": "enterprises/project-id/structures/structure-id/rooms/room-id",
          "displayName": "device-room-name"
        }
      ]
    }
  ]
}

हर डिवाइस के लिए device-id को कॉपी करें. अन्य एपीआई कॉल के लिए आपको इसकी ज़रूरत पड़ेगी.

किसी डिवाइस की जानकारी पाना

किसी डिवाइस की जानकारी पाने के लिए, device-id एंडपॉइंट पर GET कॉल करें:

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices/device-id' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

जवाब पहले की तरह ही होना चाहिए, लेकिन सिर्फ़ खास डिवाइस के लिए:

{
  "name": "enterprises/project-id/devices/device-id",
  "type": "sdm.devices.types.device-type",
  "traits": { ... },
  "parentRelations": [
    {
      "parent": "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName": "device-room-name"
    }
  ]
}

कोई निर्देश चलाएं

जीईटी कॉल के ज़रिए अपने ऐक्सेस की पुष्टि करने के बाद, आपने जिस तरह के डिवाइस को अनुमति दी है उसके मुताबिक निर्देश दें:

थर्मोस्टैट

curl -X POST \
  'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices/device-id:executeCommand' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer access-token' \
  --data-raw '{
    "command" : "sdm.devices.commands.ThermostatMode.SetMode",
    "params" : {
      "mode" : "HEAT"
    }
  }'

कैमरा

curl -X POST \
  'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices/device-id:executeCommand' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer access-token' \
  --data-raw '{
    "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
    "params" : {}
  }'

अगर आपका कॉल सफल होता है, तो नीचे दिए गए नतीजे होते हैं:

थर्मोस्टैट

आपको कोई जवाब नहीं मिलता है और फ़िज़िकल थर्मोस्टैट अपने मौजूदा मोड को कमांड पैरामीटर में बताए गए मोड में बदल देता है.

{}

कैमरा

आपको लाइव स्ट्रीम का यूआरएल और उससे जुड़े टोकन मिलते हैं.

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

समस्या हल करना

प्रमाणीकृत नहीं किया गया

एसडीएम एपीआई के ऐक्सेस टोकन, सिर्फ़ एक घंटे के लिए मान्य होते हैं. अगर आपको बिना पुष्टि वाला जवाब मिलता है, तो हो सकता है कि टोकन की समयसीमा खत्म हो गई हो. नया ऐक्सेस टोकन पाने के लिए, अपने रीफ़्रेश टोकन का इस्तेमाल करें.

दूसरी गड़बड़ियां

गड़बड़ी कोड Device Access की पूरी सूची देखने के लिए गड़बड़ी कोड का संदर्भ देखें.