Działania wymagane do 30 listopada 2026 r.: wycofujemy hostowane przez Google tematy Pub/Sub dotyczące zdarzeń. Jeśli Twoja integracja korzysta z tematu hostowanego przez Google, musisz przenieść się na hostowany samodzielnie temat Pub/Sub przed 30 listopada 2026 r., aby nadal otrzymywać powiadomienia o zdarzeniach.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Schemat wentylatora

Nest Thermostat

sdm.devices.traits.Fan

Ta cecha należy do każdego urządzenia, które ma możliwość sterowania wentylatorem.

Pola

Pole	Opis	Typ danych
`timerMode`	Aktualny tryb timera.	`string` Wartości: „ON”, „OFF”
`timerTimeout`	Znacznik czasu w formacie RFC 3339, o którym tryb timera zostanie wyłączony.	`string` Przykład: „2019-05-10T03:22:54Z”

Przykładowe żądanie i odpowiedź GET

Żądanie

GET /enterprises/project-id/devices/device-id

Odpowiedź

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

Polecenia

SetTimer

Zmień timer wentylatora.

Żądanie i odpowiedź SetTimer

Żądanie

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

Odpowiedź

{}

Pola żądania SetTimer

Pole	Opis	Typ danych
`timerMode`	Tryb, w którym ma działać timer wentylatora.	`string` Wartości: „ON”, „OFF”
`duration`	Opcjonalnie. Określa czas w sekundach, przez jaki ma działać timer.	`string` Zakres: "1s" do "43200s" Wartość domyślna: "900s"

Błędy

W związku z tą cechą mogą być zwracane te kody błędów:

Komunikat o błędzie	RPC	Rozwiązywanie problemów
Wentylator termostatu jest niedostępny.	`FAILED_PRECONDITION`	Termostat nie ma funkcji wentylatora. W przypadku tego urządzenia nie można używać cech i poleceń związanych z wentylatorem.

Pełną listę kodów błędów interfejsu API znajdziesz w dokumencie API Error Code Reference kodów błędów interfejsu API.