Interfejs API aparatu

Interfejs Nest API działa ze wszystkimi modelami Nest CamTM.

Użytkownicy mogą dodawać wiele kamer Nest Cam do grupy devices/cameras, aż do maksymalnej liczby przypadającej na strukturę. Kiedy wywołujesz tę lokalizację danych, masz dostęp do danych Nest Cam (wartości danych dla urządzeń w strukturze).

Wszystkie poniższe wartości znajdują się poniżej każdego ciągu devices/cameras/device_id w dokumencie JSON.

device_id,

Unikalny identyfikator Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/device_id
Zwrotystring
Przykład: "awJo6rH..."
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

wersja_oprogramowania

Wersja oprogramowania.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/software_version
Zwrotystring
Przykład: "4,0&quot
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

struktura_id

Unikalny identyfikator struktury.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/structure_id
Zwrotystring
Przykład: "VqFabWH21nw..."
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

gdzie_identyfikator

Unikalny identyfikator wygenerowany przez Nest, który reprezentuje name – wyświetlaną nazwę urządzenia.

Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/where_id
Zwrotystring
Przykład: "d6reb_OZTM..."
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

gdzie_nazwa

Wyświetlana nazwa urządzenia. Powiązane z kamerą Nest Cam where_id. Może to być dowolna nazwa sali lub wybierz ją z naszej listy. Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/where_name
Zwrotystring
Przykład: "Hallway"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v3
Odczyt z kamery + obrazy / v4
Odczyt/zapis w kamerze / v3
Odczyt/zapis aparatu + obrazy / v4

name

Wyświetlana nazwa urządzenia. Może to być dowolna nazwa sali lub wybierz ją z naszej listy.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/name
Zwrotystring
Przykład: "Hallway"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

nazwa_długa

Długa wyświetlana nazwa urządzenia. Obejmuje atrybut niestandardowy (etykieta), utworzony przez użytkownika lub za pomocą wheres.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/name_long
Zwrotystring
Przykład: "Hallway Nest Cam (na piętrze)"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

online

Stan połączenia urządzenia z usługą Nest.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/is_online
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

strumieniowanie_danych

Stan kamery, włączone lub aktywne strumieniowanie wideo, lub wyłączone. Więcej informacji znajdziesz w artykule na temat sposobu działania kamery z Asystentem wyjścia/powrotu.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
Zwrotyboolean
Wartości: true, false
Dostępodczyt/zapis
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

is_audio_input_enabled

Stan mikrofonu kamery – włączony i włączony lub wyłączony. Więcej informacji o ustawieniach dźwięku Nest Cam.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

ostatnia_zmiana_online

Sygnatura czasowa wskazująca ostatnią zmianę stanu online w formacie ISO 8601.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
Zwrotystring
Przykład: "2016-12-29T18:42:00.000Z"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

is_video_history_enabled

Stan subskrypcji Nest Aware (aktywna lub nieaktywna).

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

adres_internetowy

Internetowy link (precyzyjny link) do transmisji wideo na żywo na home.nest.com.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/web_url
Zwrotystring
Przykład: "https://home.nest.com/cameras/device_id?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

app_url,

Adres URL aplikacji (precyzyjny link) do transmisji na żywo w aplikacji Nest.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/app_url
Zwrotystring
Przykład: "nestmobile://cameras/device_id?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

is_public_share_enabled

Użytkownicy mogą udostępnić swój film i udostępnić go każdemu. Po włączeniu udostępniania publicznego możesz czytać: public_share_url

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v3-v4
Odczyt/zapis w kamerze + obrazy / v3-v4

strefy_aktywności

Zwraca tablicę wszystkich zdefiniowanych stref aktywności.

Strefy aktywności służą do monitorowania zdarzeń ruchu w zdefiniowanych przez użytkownika obszarach strumienia wideo. Wymaga Nest Aware.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
Zwrotyarray
Przykład: [ {"name" : "string1", "id" : "string2"},... ]

string1 to nazwa strefy (zdefiniowana przez użytkownika lub wygenerowana automatycznie) podczas jej tworzenia.
string2 to identyfikator przypisywany przez Nest podczas tworzenia strefy aktywności.
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v3-v4
Odczyt/zapis w kamerze + obrazy / v3-v4

URL_udostępnienia_publicznego

Dostęp do tego adresu URL można uzyskać, gdy użytkownik udostępni strumień wideo publicznie.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
Zwrotystring
Przykład: "https://video.nest.com/live/string1?string2"

string1 jest nazwą strumienia wideo (zdefiniowaną przez użytkownika lub wygenerowaną automatycznie, gdy strumień jest ustawiony jako publiczny).
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v3-v4
Odczyt/zapis w kamerze + obrazy / v3-v4

URL_zrzutu

Zrób zdjęcie na żądanie. Zwraca adres URL obrazu zrobionego na żywo. Wymaga włączonej kamery i transmisji na żywo.

Użyj tego pola, aby utworzyć zrzut z transmisji na żywo.

  • snapshot_url – zwraca adres URL obrazu zarejestrowanego za pomocą aktywnej transmisji wideo.
  • Wymaga włączonej kamery i aktywnego przesyłania strumieniowego

Jakość zrzutu z interfejsu API wynosi 1080p, jeśli:

  • aktywny podgląd strumienia danych z kamery w aplikacji (web_url)
  • aktywnie wyświetlając strumień publiczny (app_url)
  • zasubskrybowano Nest Aware

Jeśli nie wyświetlasz aktywnie strumienia lub nie masz subskrypcji Nest Aware, interfejs API nie ma żadnego źródła 1080p, z którego można pobrać zrzut w tej rozdzielczości, i wygenerować obraz w niższej jakości. Niska przepustowość sieci lokalnej może też spowodować spadek rozdzielczości zrzutu interfejsu API poniżej 1080p przy obecności Nest Aware.

Dowiedz się więcej o wymaganiach związanych z przepustowością kamer Nest.

W zależności od stanu subskrypcji Nest Aware w przypadku tego połączenia obowiązują limity.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
Zwrotystring
Przykład: "string1/device_id/string2?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v3-v4
Odczyt/zapis w kamerze + obrazy / v3-v4

ostatnie_zdarzenie

Ten obiekt rejestruje informacje o ostatnim zdarzeniu, które wywołało powiadomienie.

Niektóre pola i niektóre kombinacje uprawnień wymagają subskrypcji Nest Aware, aby uzyskać dostęp do informacji o ostatnim zdarzeniu.

Wszystkie poniższe wartości znajdują się poniżej każdego ciągu devices/cameras/device_id/last_event w dokumencie JSON.

has_sound,

Zdarzenie dźwiękowe – wykryto dźwięk.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

has_motion

Zdarzenie ruchu – wykryto ruch.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

zawiera_osoba

Zdarzenie dotyczące osoby – wykryto osobę.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
Zwrotyboolean
Wartości: true, false
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

start_time,

Godzina rozpoczęcia wydarzenia w formacie ISO 8601.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
Zwrotystring
Przykład: "2016-12-29T00:00:00.000Z"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

godzina_zakończenia

Godzina zakończenia wydarzenia w formacie ISO 8601.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
Zwrotystring
Przykład: "2016-12-29T00:00:00.000Z"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

url_adresy_url

Sygnatura czasowa w formacie ISO 8601, która identyfikuje wygaśnięcie następujących adresów URL związanych ze zdarzeniami:

Czas wygaśnięcia jest obliczany w ten sposób: last_event/start_time + n dni (w których n = 10 lub 30 dni w zależności od subskrypcji Nest Aware).

Wymaga Nest Aware.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
Zwrotystring
Przykład: "2016-12-29T00:00:00.000Z"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

adres_internetowy

Adres URL internetowy (precyzyjny link) do ostatniego zdarzenia dźwiękowego lub ruchu na home.nest.com. Służy do wyświetlania ostatniego zarejestrowanego zdarzenia i wymaga zalogowania się na konto.

Wymaga Nest Aware. Jeśli URL zdarzenia wygasł lub urządzenie nie ma aktywnej subskrypcji, ta wartość nie zostanie uwzględniona w ładunku.

Więcej informacji na ten temat znajdziesz na stronie last_event/urls_expire_time.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
Zwrotystring
Przykład: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

app_url,

Adres URL aplikacji Nest (precyzyjny link) do ostatniego dźwięku lub ruchu. Służy do wyświetlania ostatniego zarejestrowanego zdarzenia i wymaga zalogowania się na konto.

Wymaga Nest Aware. Jeśli URL zdarzenia wygasł lub urządzenie nie ma aktywnej subskrypcji, ta wartość nie zostanie uwzględniona w ładunku.

Więcej informacji na ten temat znajdziesz na stronie last_event/urls_expire_time.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
Zwrotystring
Przykład: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu / v1-v3
Odczyt z kamery + obrazy / v1-v4
Odczyt/zapis aparatu / v1-v3
Odczyt/zapis w kamerze + obrazy / v1-v4

image_url,

Adres URL (link) do pliku zdjęcia utworzonego w związku ze zdarzeniem dźwiękowym lub ruchomym.

Wymaga Nest Aware. Więcej informacji na temat czasu wygaśnięcia tego adresu URL znajdziesz na stronie last_event/urls_expire_time.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
Zwrotystring
Przykład: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v1-v4
Odczyt/zapis w aparacie + obrazy / v1-v4

animowany_adres_URL_obrazu

Adres URL (link) do pliku GIF zarejestrowanego w zdarzeniach dźwiękowych lub ruchomych.

Wymaga Nest Aware.

Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url
Zwrotystring
Przykład: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v1-v4
Odczyt/zapis w aparacie + obrazy / v1-v4

Identyfikatory_stref_aktywności

Identyfikatory stref aktywności, w których wykryto zdarzenie ruchu.

Wymaga Nest Aware. Jeśli używasz ich z tablicą activity_zones, możesz pobrać nazwę strefy z tych identyfikatorów.

Jeśli last_event/has_motion to

  • true = zwraca identyfikatory strefy aktywności, w których wykryto zdarzenie ruchu
  • false = zwraca pustą tablicę
Szczegóły
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
Zwrotyarray
Przykład: [ string1, string2,... ]
Dostęptylko do odczytu
Dostępne wOdczyt z aparatu + obrazy / v3-v4
Odczyt/zapis w kamerze + obrazy / v3-v4