Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
trait w SDM API obejmuje pola, polecenia i zdarzenia.
Pola
Pola to wartości z typowymi typami danych, takimi jak liczba czy ciąg znaków. Na przykład pole może zawierać informacje o bieżącym trybie lub wilgotności otoczenia na urządzeniu Google Nest Thermostat.
Cechy i pola można wyświetlać za pomocą wywołania GET do wybranego punktu końcowego interfejsu API:
Wartości sdm.devices.types.device-type zwróconej przez interfejs SDM API nie należy używać do określania działania urządzenia, do którego jest przypisane. Nie możemy zagwarantować, że dany typ urządzenia będzie działać stabilnie na danym urządzeniu, ponieważ do interfejsu SDM API będzie dodawane kolejne funkcje. Zamiast tego użyj zwróconych cech urządzenia.
parentRelations
Obiekt parentRelations reprezentuje zasób nadrzędny bieżącego zasobu, czyli strukturę lub salę. Wyświetlana nazwa odpowiada polu customName w:
cechy informacyjnej
urządzeń z atrybutem nadrzędnym struktur lubRoomInfo
Polecenia
Polecenia to żądania powiązane z daną cechą. Może to być na przykład zmiana bieżącego trybu lub nastawy temperatury na urządzeniu Google Nest Thermostat.
Polecenie jest wysyłane przez wywołanie interfejsu API executeCommand:
Większość odpowiedzi na polecenie oznacza prosty sukces lub błąd. Przykłady użycia poleceń znajdziesz w przewodnikach po poszczególnych cechach.
Wydarzenia
Zdarzenia są asynchroniczne i zarządzane przez Google Cloud Pub/Sub w 1 temacie na każdy identyfikator Project .
Zdarzenia są wysyłane domyślnie w przypadku każdej zmiany wartości pola cechy. Można je też wysyłać w odpowiedzi na określone działania na urządzeniu lub zmiany w przypisaniach zasobów. Więcej informacji znajdziesz w sekcji Zdarzenia.