Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
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