Как использовать API

Имея на руках токен доступа и сделав первоначальный вызов списка устройств, вы готовы использовать API SDM для доступа к своему устройству и управления им.

Список структур и устройств

Используйте curl , чтобы выполнить простой вызов GET к конечной точке structures :

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

Если вы еще этого не сделали, выполните вызов GET к конечной точке devices , чтобы получить список устройств:

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 для каждого устройства, он понадобится вам для других вызовов API.

Получить информацию об устройстве

Чтобы получить информацию о конкретном устройстве, выполните вызов GET к конечной точке 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'

Ответ должен быть таким же, как и раньше, но только для конкретного устройства:

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

Выполнить команду

После подтверждения вашего доступа успешным вызовом GET попробуйте выполнить команду в зависимости от типа авторизованного вами устройства:

ТЕРМОСТАТ

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

Если ваш вызов успешен, произойдет следующее:

ТЕРМОСТАТ

Вы получаете пустой ответ и физический термостат меняет свой текущий режим на режим, указанный в параметрах команды.

{}

КАМЕРА

Вы получаете URL-адрес прямой трансляции и связанные токены.

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

Поиск неисправностей

Неаутентифицированный

Токены доступа для API SDM действительны только в течение 1 часа. Если вы получили ответ UNAUTHENTICATED, вероятно, срок действия токена истек. Используйте свой токен обновления , чтобы получить новый токен доступа.

Другие ошибки

Полный список см. в справочнике по кодам ошибок. Device Access коды ошибок.