Usa la API

Con un token de acceso en mano y la llamada inicial a la lista de dispositivos realizada, ya puedes usar la API de SDM para acceder a tu dispositivo y controlarlo.

Cómo enumerar estructuras y dispositivos

Usa curl para realizar una llamada GET simple al extremo structures:

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

Una llamada correcta devuelve una lista de estructuras para las cuentas vinculadas a tu proyecto deDevice Access :

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

Si aún no lo hiciste, realiza una llamada GET al extremo devices para obtener una lista de dispositivos:

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

Una llamada exitosa devuelve una lista de los dispositivos vinculados a tu proyecto de Device Access. Cada dispositivo tiene su propia lista única de características disponibles:

{
  "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"
        }
      ]
    }
  ]
}

Copia el device-id de cada dispositivo, ya que lo necesitarás para otras llamadas a la API.

Obtén información sobre un dispositivo

Para obtener información sobre un dispositivo específico, realiza una llamada GET al extremo device-id:

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

La respuesta debería ser similar a la anterior, pero solo para el dispositivo específico:

{
  "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"
    }
  ]
}

Ejecutar un comando

Después de validar tu acceso con una llamada GET exitosa, intenta ejecutar un comando según el tipo de dispositivo que autorizaste:

THERMOSTAT

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

CÁMARA

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" : {}
  }'

Si la llamada se realiza correctamente, se producen los siguientes resultados:

THERMOSTAT

Recibirás una respuesta vacía y el termostato físico cambiará su modo actual al modo especificado en los parámetros del comando.

{}

CÁMARA

Recibirás una URL de transmisión en vivo y tokens relacionados.

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

Solución de problemas

Sin autenticar

Los tokens de acceso para la API de SDM solo son válidos durante 1 hora. Si recibes una respuesta UNAUTHENTICATED, es probable que el token haya vencido. Usa tu token de actualización para obtener un nuevo token de acceso.

Otros errores

Consulta la Referencia de códigos de error para obtener la lista completa de códigos de error de Device Access .