Mając token dostępu i pierwsze wywołanie listy urządzeń, jest gotowy do użycia interfejsu SDM API w celu uzyskania dostępu do urządzenia i sterowania nim.
Wyświetl listę struktur i urządzeń
Użyj curl
, aby utworzyć proste wywołanie GET do punktu końcowego structures
:
curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/structures' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access-token'
Udane wywołanie zwraca listę struktur dla kont połączonych z Twoim Device Access projekt:
{ "structures": [ { "name": "enterprises/project-id/structures/structure-id", "traits": { "sdm.structures.traits.Info": { "customName": "structure-name" } } } ] }
Wykonaj wywołanie GET do punktu końcowego devices
, aby
podaj listę urządzeń:
curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access-token'
Udane połączenie zwraca listę urządzeń połączonych z Twoim urządzeniem Device Access w projektach AI. Każde urządzenie ma własną, unikalną listę dostępnych cech:
{ "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" } ] } ] }
Skopiuj identyfikator device-id dla każdego urządzenia. Będzie on potrzebny w przypadku innych wywołań interfejsu API.
Uzyskiwanie informacji o urządzeniu
Aby uzyskać informacje dotyczące konkretnego urządzenia, zadzwoń GET pod numer device-id punkt końcowy:
curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices/device-id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer access-token'
Odpowiedź powinna być podobna jak wcześniej, ale dotyczy tylko konkretnego urządzenia:
{ "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" } ] }
Wykonywanie polecenia
Po zweryfikowaniu dostępu za pomocą udanego wywołania GET spróbuj wykonać w zależności od typu autoryzowanego urządzenia:
TERMOSTAT
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"
}
}'
APARAT
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" : {}
}'
Jeśli połączenie się powiedzie, pojawią się te wyniki:
TERMOSTAT
Otrzymujesz pustą odpowiedź, a fizyczny termostat zmienia swoją w bieżącym trybie na tryb określony w parametrach polecenia.
{}
APARAT
Otrzymujesz adres URL transmisji na żywo i powiązane tokeny.
{ "results" : { "streamUrls" : { "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken" }, "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "streamToken" : "g.0.streamingToken", "expiresAt" : "2018-01-04T18:30:00.000Z" } }
Rozwiązywanie problemów
Nieuwierzytelnione
Tokeny dostępu do interfejsu SDM API są ważne tylko przez 1 godzinę. Jeśli otrzymasz odpowiedź NIEUWIERZYTELNIONE, token prawdopodobnie utracił ważność. Użyj odśwież token, aby uzyskać nowy token dostępu.
Inne błędy
Zapoznaj się z informacjami o kodach błędów, aby dowiedzieć się pełna lista Device Access kodów błędów.