Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Struktura

Struktury

Struktury gniazd reprezentują struktury fizyczne w świecie rzeczywistym. Zwykle jest to dom użytkownika, służy jako punkt organizacyjny dla urządzeń i przechowuje dane dotyczące całego domu.

Nest API zapewnia dostęp do następujących danych na poziomie struktury, w zależności od poziomu przyznanych uprawnień:

  • Nazwa struktury i „gdzie nazwa” urządzenia (lokalizacja w domu)
  • Lista urządzeń w domu
  • Status zdarzenia energetycznego ( godzina szczytu energii )
  • Stan poza domem
  • ETA użytkownika
  • Stan bezpieczeństwa
  • Kod pocztowy lub kod pocztowy

Niektóre funkcje na poziomie struktury są opisane w osobnych, bardziej szczegółowych przewodnikach po API:

Uprawnienia do struktury

Aby uzyskać dostęp do ... Wybierz...
Większość wartości danych w obiekcie structures Pozwolenia na wyjazd , ETA , energię lub kod pocztowy
name wartości danych w obiekcie structures Uprawnienia do odczytu / zapisu struktury

Zobacz, jak działają uprawnienia w interaktywnej dokumentacji interfejsu API .

Identyfikatory struktur

Imię

Domyślną nazwą struktury jest „Home”, ale może to być dowolny ciąg wybrany przez użytkownika. Po wybraniu uprawnienia do odczytu / zapisu struktury możesz zmienić name struktury.

Gdzie

wheres jest obiektem ustawionym na strukturze, zawierającym identyfikatory gdzie ( where_id i name ). Użyj wheres do tworzenia niestandardowych nazw miejsc lub dostępu do standardów, w których nazwy.

Dostęp do wheres obiektu wymaga aparatu , dym + CO Alarm lub Termostat uprawnienia.

where_id

  • Unikalny, wygenerowany przez Nest identyfikator, który reprezentuje name
  • where_id jest tylko do odczytu i jest tworzony automatycznie w wywołaniu w celu utworzenia niestandardowej name gdzie

name

  • Wyświetlana nazwa urządzenia; Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa
  • Aby utworzyć niestandardową name gdzie, wykonaj wywołanie POST, aby napisać nową, niestandardową name gdzie; w where_id zwracany jest where_id
  • Rozważania
    • name nie można edytować ani usuwać po utworzeniu
    • name musi być unikalna w obrębie struktury
    • Jeśli urządzenie jest sparowane ze strukturą, niestandardowa name skojarzona z urządzeniem jest dostępna w /structures/ path
    • Aby przenieść urządzenie z niestandardową name do innej struktury, usuń sparowanie urządzenia, a następnie ponownie sparuj urządzenie z żądaną nazwą

Dowiedz się więcej o nazwach termostatów Nest, osłon Nest i kamer Nest .

Inne metadane

Wszystkie wartości danych są tylko do odczytu, chyba że określono inaczej.

Wartość danych Opis
structure_id Ciąg, który w unikalny sposób reprezentuje tę strukturę. Każdy programista zobaczy inny identyfikator dla tej samej struktury, ale wiele produktów tego samego programisty będzie miało ten sam identyfikator
country_code Kod kraju w standardzie ISO 3166-1 alfa-2, który odpowiada zarejestrowanej lokalizacji konstrukcji
postal_code Kod pocztowy lub pocztowy, w zależności od kraju
time_zone Ciąg stref czasowych IANA, który jest mapowany na strefę czasową struktury

Cechy struktury

Stany alarmowe dymu i CO

Kiedy wybierzesz uprawnienia odczytu Smoke + CO , możesz uzyskać dostęp do smoke_alarm_state i co_alarm_state w obiekcie structures . Te same wartości danych są również dostępne w obiekcie urządzenia ( devices/smoke_co_alarms ).

Więcej informacji na temat tych stanów można znaleźć w przewodniku po alarmach Smoke + CO .

Wiele wartości danych współpracuje ze sobą, aby określić, jak urządzenia zachowują się w strukturze.

  • Gdy struktura away stan jest ustawiony away słowo „ECO” jest wyświetlany na gniazdo termostatu, w preferowanym języku użytkownika
  • Gdy struktura away stan jest ustawiony away , można:
    • ustaw fan_timer_active
    • zmień target_temperature_f lub target_temperature_c
  • Gdy stan away struktury jest ustawiony na home , możesz:
    • zadzwoń do ETA (ustaw identyfikator podróży i okno przyjazdu)
  • Gdy wyłączenie awaryjne jest aktywne, nie można ustawić fan_timer_active
  • Gdy ogrzewanie awaryjne jest włączone, nie można ustawić struktury w away

Wiele struktur

Możliwe, że użytkownik ma więcej niż jedną strukturę dołączoną do swojego konta Nest, więc produkt powinien oferować użytkownikowi możliwość wyboru spośród dostępnych struktur (selektor struktur).

Selektor struktur

Na przykład podczas ustawiania ETA ważne jest, aby użytkownik mógł wybrać strukturę miejsca docelowego ETA. W podobny sposób użytkownik mógłby mieć dwa czujniki dymu w „salonie” dwóch różnych domów. Jeśli chcesz przeprowadzić korelację struktury z własną koncepcją domu, zalecamy zrobienie tego podczas procesu autoryzacji.

Dowiedz się, jak użytkownicy zarządzają urządzeniami w wielu strukturach .

Wartości maksymalne urządzenia

Istnieją ograniczenia dotyczące liczby urządzeń obsługiwanych przez Nest w strukturze.

Rodzaj urządzenia Max na strukturę
Nest Thermostat 20
Kamery Nest 10
Nest Protect 18

Komunikaty o błędach

Aby uzyskać informacje o tym, co oznaczają błędy wywołań interfejsu API i jak sobie z nimi radzić, zobacz komunikaty o błędach .