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

Camera API

Nest API działa ze wszystkimi modelami Nest Cam ™.

Użytkownicy mogą dodawać wiele devices/cameras Nest do grupy devices/cameras , do maksymalnej liczby devices/cameras na strukturę . Wykonując połączenie z tą lokalizacją danych, możesz uzyskać dostęp do danych kamery Nest Cam (wartości danych dla urządzeń w strukturze).

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

identyfikator urzadzenia

Unikalny identyfikator kamery Nest Cam.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Zwroty string
Przykład: „awJo6rH ...”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

wersja oprogramowania

Wersja oprogramowania.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Zwroty string
Przykład: „4,0”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

identyfikator struktury

Niepowtarzalny identyfikator struktury.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Zwroty string
Przykład: „VqFabWH21nw ...”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

gdzie_id

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

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

Detale
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Zwroty string
Przykład: „d6reb_OZTM ...”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

gdzie_nazwa

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

Detale
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Zwroty string
Przykład: „Przedpokój”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v3
Odczyt aparatu + obrazy / v4
Aparat do odczytu / zapisu / v3
Odczyt / zapis aparatu + obrazy / v4

imię

Wyświetl nazwę urządzenia; Może to być dowolna nazwa pokoju z dostarczonej przez nas listy lub nazwa niestandardowa.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /name
Zwroty string
Przykład: „Przedpokój”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

name_long

Długa wyświetlana nazwa urządzenia. Obejmuje niestandardową (etykietę), utworzoną przez użytkownika lub przez wheres .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Zwroty string
Przykład: „Kamera Nest Cam w korytarzu (na piętrze)”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

jest online

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

Detale
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

is_streaming

Stan kamery: włączona i aktywnie przesyłająca wideo lub wyłączona. Aby uzyskać więcej informacji, zobacz Jak działa kamera z Asystentem w domu / poza domem .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Zwroty boolean
Wartości: prawda, fałsz
Dostęp czytać / pisać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

is_audio_input_enabled

Stan mikrofonu aparatu: włączony i nasłuchujący lub wyłączony. Dowiedz się więcej o ustawieniach dźwięku Nest Cam .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

last_is_online_change

Znacznik czasu, który identyfikuje ostatnią zmianę statusu online, w formacie ISO 8601 .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
Zwroty string
Przykład: „2016-12-29T18: 42: 00.000Z”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

is_video_history_enabled

Status subskrypcji Nest Aware (subskrypcja aktywna lub nie).

Detale
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

web_url

Adres URL sieci Web ( precyzyjny link) do strumienia wideo na żywo pod adresem home.nest.com .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /web_url
Zwroty string
Przykład: „ https://home.nest.com/cameras/ device_id ?auth= camera_token
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

app_url

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

Detale
https://developer-api.nest.com/devices/cameras/ device_id /app_url
Zwroty string
Przykład: „ nestmobile://cameras/ device_id ?auth= camera_token
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

is_public_share_enabled

Użytkownicy mogą udostępniać swoje filmy wideo i udostępniać je każdemu. Gdy udostępnianie publiczne jest włączone, możesz czytać public_share_url .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v3-v4
Kamera do odczytu / zapisu + obrazy / v3-v4

activity_zones

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 .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
Zwroty array
Przykład: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 to nazwa strefy zdefiniowana przez użytkownika lub wygenerowana automatycznie podczas tworzenia strefy.
string2 to identyfikator przypisywany przez Nest podczas tworzenia Strefy Aktywności.
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v3-v4
Kamera do odczytu / zapisu + obrazy / v3-v4

public_share_url

Możesz uzyskać dostęp do tego adresu URL, gdy użytkownik udostępni swój strumień wideo jako publiczny .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Zwroty string
Przykład: „ https://video.nest.com/live/ string1 ? string2

string1 to nazwa strumienia wideo, zdefiniowana przez użytkownika lub generowana automatycznie, gdy strumień jest ustawiony jako publiczny.
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v3-v4
Kamera do odczytu / zapisu + obrazy / v3-v4

snapshot_url

Zrób zdjęcie na żądanie. Zwraca adres URL obrazu przechwyconego ze strumienia wideo na żywo. Wymaga włączonej kamery i aktywnego przesyłania strumieniowego.

Użyj tego pola, aby uzyskać migawkę ze strumienia wideo na żywo.

  • snapshot_url - zwraca adres URL obrazu przechwyconego ze strumienia wideo na żywo
  • Wymaga włączonej kamery i aktywnego przesyłania strumieniowego

Jakość migawki z interfejsu API to tylko przepustowość 1080p, jeśli:

  • aktywne przeglądanie strumienia z kamery w aplikacji ( web_url )
  • aktywne przeglądanie publicznego strumienia ( app_url )
  • zasubskrybował Nest Aware

Jeśli nie przeglądasz aktywnie strumienia lub nie masz subskrypcji Nest Aware, interfejs API nie ma źródła 1080p, z którego można by pobrać migawkę w tej rozdzielczości i generuje obraz o niższej jakości. Ponadto niska przepustowość sieci lokalnej może spowodować, że rozdzielczość migawki interfejsu API spadnie poniżej 1080p przy obecności Nest Aware.

Dowiedz się więcej o wymaganiach dotyczących przepustowości dla kamer Nest .

W przypadku tej rozmowy obowiązują limity stawek w zależności od statusu subskrypcji Nest Aware.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
Zwroty string
Na przykład: " string1 / device_id / string2 ?auth= camera_token "
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v3-v4
Kamera do odczytu / zapisu + obrazy / v3-v4

ostatnie wydarzenie

Ten obiekt przechwytuje informacje o ostatnim zdarzeniu, które wyzwoliło powiadomienie.

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

Wszystko poniżej wartości znajdują się pod każdym devices/cameras/ device_id /last_event w dokumencie JSON.

has_sound

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

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

has_motion

Zdarzenie ruchu - wykryto ruch.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

has_person

Zdarzenie dotyczące osoby - wykryto osobę.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Zwroty boolean
Wartości: prawda, fałsz
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

czas rozpoczęcia

Czas rozpoczęcia wydarzenia w formacie ISO 8601 .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
Zwroty string
Przykład: „2016-12-29T00: 00: 00.000Z”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

Koniec czasu

Czas zakończenia wydarzenia w formacie ISO 8601 .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
Zwroty string
Przykład: „2016-12-29T00: 00: 00.000Z”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

urls_expire_time

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

Czas wygaśnięcia jest obliczany jako: last_event/start_time + n dni (gdzie n = 10 lub 30 dni, w zależności od planu subskrypcji Nest Aware).

Wymaga Nest Aware .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
Zwroty string
Przykład: „2016-12-29T00: 00: 00.000Z”
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

web_url

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

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

Zobacz last_event/urls_expire_time aby uzyskać informacje na temat czasu wygaśnięcia tego adresu URL.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
Zwroty string
Przykład: „ https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

app_url

Nest URL aplikacji (precyzyjny link) do ostatniego zdarzenia dźwiękowego lub ruchu. Służy do wyświetlania ostatniego zarejestrowanego zdarzenia i wymaga zalogowania użytkownika do konta.

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

Zobacz last_event/urls_expire_time aby uzyskać informacje na temat czasu wygaśnięcia tego adresu URL.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
Zwroty string
Przykład: „ nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token
Dostęp tylko czytać
Dostępne w Odczyt z aparatu / v1-v3
Odczyt aparatu + obrazy / v1-v4
Aparat do odczytu / zapisu / v1-v3
Kamera do odczytu / zapisu + obrazy / v1-v4

image_url

Adres URL (łącze) do pliku obrazu przechwyconego dla zdarzenia dźwiękowego lub ruchu.

Wymaga Nest Aware . Zobacz last_event/urls_expire_time aby uzyskać informacje na temat czasu wygaśnięcia tego adresu URL.

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
Zwroty string
Na przykład: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v1-v4
Kamera do odczytu / zapisu + obrazy / v1-v4

animated_image_url

URL (link) do pliku gif przechwyconego dla zdarzenia dźwiękowego lub ruchu.

Wymaga Nest Aware .

Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
Zwroty string
Na przykład: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v1-v4
Kamera do odczytu / zapisu + obrazy / v1-v4

activity_zone_ids

Identyfikatory stref aktywności, które wykryły zdarzenie ruchu.

Wymaga Nest Aware . W przypadku użycia z tablicą activity_zones można uzyskać nazwę strefy z tych identyfikatorów.

Jeśli last_event/has_motion to

  • true = zwraca identyfikatory stref aktywności, które wykryły zdarzenie ruchu
  • false = zwraca pustą tablicę
Detale
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Zwroty array
Przykład: [ string1 , string2 ,... ]
Dostęp tylko czytać
Dostępne w Odczyt aparatu + obrazy / v3-v4
Kamera do odczytu / zapisu + obrazy / v3-v4