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