Kamera-API

Die Nest API funktioniert mit allen Nest Cam™-Modellen.

Benutzer können mehr Nest Cams zum hinzufügen devices/cameras Gruppe, bis zum Maximum pro Struktur . Wenn Sie diesen Datenstandort anrufen, können Sie auf Nest Cam-Daten (Datenwerte für Geräte in der Struktur) zugreifen.

Die folgenden Werte Alle sind unter jedem gefundenen devices/cameras/ device_id im JSON - Dokument.

Geräte ID

Eindeutige Kennung der Nest Cam.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Kehrt zurück	string Beispiel: "awJo6rH..."
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

Softwareversion

Softwareversion.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Kehrt zurück	string Beispiel: "4.0"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

Struktur_id

Eindeutige Kennung der Struktur.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Kehrt zurück	string Beispiel: "VqFabWH21nw..."
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

where_id

Ein einzigartiger, Nest-generierten Identifikator, der darstellt , name , der Anzeigename der Vorrichtung.

Erfahren Sie mehr darüber , wo Namen für Nest Thermostats ,Nest schützt und Nest Cams .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Kehrt zurück	string Beispiel: "d6reb_OZTM..."
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

wo_name

Der Anzeigename des Geräts. Im Zusammenhang mit dem Nest Cam where_id . Kann ein beliebiger Raumname aus einer von uns bereitgestellten Liste oder ein benutzerdefinierter Name sein. Erfahren Sie mehr darüber , wo Namen für Nest Thermostats ,Nest schützt und Nest Cams .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Kehrt zurück	string Beispiel: "Flur"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v3 Kamera lesen + Bilder / v4 Kamera lesen/schreiben / v3 Kamera lesen/schreiben + Bilder / v4

Name

Anzeigename des Geräts; kann ein beliebiger Raumname aus einer von uns bereitgestellten Liste oder ein benutzerdefinierter Name sein.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /name
Kehrt zurück	string Beispiel: "Flur"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

name_long

Langer Anzeigename des Geräts. Enthält ein benutzerdefiniertes (Etikett), vom Benutzer erstellt oder über wheres .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Kehrt zurück	string Beispiel: "Flur Nest Cam (oben)"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

ist online

Geräteverbindungsstatus mit dem Nest-Dienst.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

is_streaming

Kamerastatus, entweder ein und aktives Videostreaming oder aus. Siehe Wie Sie Ihre Kamera arbeitet mit Heim / Auswärts Assist für weitere Informationen.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	lesen Schreiben
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

is_audio_input_enabled

Status des Kameramikrofons, entweder ein und zuhören oder aus. Weitere Informationen zum Nest Cam Audio - Einstellungen .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

last_is_online_change

Zeitstempel, der die letzte Änderung an den Online - Status, in identifiziert ISO 8601 - Format.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
Kehrt zurück	string Beispiel: "2016-12-29T18:42:00.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

is_video_history_enabled

Nest Aware Abonnementstatus (Abonnement aktiv oder nicht).

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

web_url

Web URL (Deeplink) zum Live - Video - Stream auf home.nest.com .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /web_url
Kehrt zurück	string Beispiel: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

app_url

App-URL (Deep Link) zum Live-Videostream in der Nest App.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /app_url
Kehrt zurück	string Beispiel: " nestmobile://cameras/ device_id ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

is_public_share_enabled

Benutzer können wählen , um ihr Video zu teilen und machen es von jedermann sichtbar. Wenn öffentliche Freigabe aktiviert ist, können Sie lesen public_share_url .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4

Aktivitätszonen

Gibt ein Array aller definierten Aktivitätszonen zurück.

Aktivitätszonen verwendet werden , um Bewegungsereignisse in benutzerdefinierten Bereichen des Videostroms zu überwachen. Benötigt Nest Aware .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
Kehrt zurück	array Beispiel: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 ist die Zonennamen entweder benutzerdefinierte oder automatisch erzeugt wird, wenn die Zone erzeugt wird. • string2 ist eine Kennung von Nest zugewiesen , wenn die Activity Zone erstellt wird.
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4

public_share_url

Sie können diese URL zugreifen , wenn ein Benutzer sein macht Video - Stream öffentlich .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Kehrt zurück	string Beispiel: " https://video.nest.com/live/ string1 ? string2 " string1 ist der Videostrom Name entweder benutzerdefinierten oder automatisch erzeugt wird, wenn der Strom für die öffentliche eingestellt ist.
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4

Snapshot_URL

Nehmen Sie bei Bedarf ein Bild auf. Gibt die URL eines Bildes zurück, das aus dem Live-Videostream aufgenommen wurde. Erfordert, dass die Kamera eingeschaltet ist und aktiv streamt.

Verwenden Sie dieses Feld, um einen Schnappschuss aus dem Live-Videostream zu erhalten.

• snapshot_url - gibt die URL eines Bildes aus dem Live - Video - Stream erfasst
• Erfordert, dass die Kamera eingeschaltet ist und aktiv streamt

Die Snapshot-Qualität der API beträgt nur 1080p-Durchsatz, wenn Sie:

• aktiv Betrachten der Kamera - Stream in der Anwendung ( web_url )
• aktiv den öffentlichen Stream sehen ( app_url )
• Nest Aware abonniert

Wenn du den Stream nicht aktiv ansiehst oder kein Nest Aware-Abo hast, hat die API keine 1080p-Quelle, um einen Schnappschuss mit dieser Auflösung abzurufen, und erzeugt ein Bild mit geringerer Qualität. Außerdem kann eine geringe lokale Netzwerkbandbreite dazu führen, dass die API-Snapshot-Auflösung unter 1080p sinkt, wenn Nest Aware vorhanden ist.

Erfahren Sie mehr über die Bandbreitenanforderungen für Nest Kameras .

Ratenbegrenzungen gelten für diesen Anruf, abhängig von Nest Aware Abonnementstatus .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
Kehrt zurück	string Beispiel: " string1 / device_id / string2 ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4

letzte Veranstaltung

Dieses Objekt erfasst Informationen über das letzte Ereignis, das eine Benachrichtigung ausgelöst hat.

Einige Felder und einige Erlaubnis Kombinationen erfordern ein Nest Aware Abonnement letzte Ereignisinformationen zuzugreifen.

Die folgenden Werte Alle sind unter jedem gefundenen devices/cameras/ device_id /last_event im JSON - Dokument.

has_sound

Tonereignis - Ton wurde erkannt.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

has_motion

Bewegungsereignis - Bewegung wurde erkannt.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

hat_person

Personenereignis - Eine Person wurde erkannt.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Kehrt zurück	boolean Werte: wahr, falsch
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

Startzeit

Ereignisstartzeit, in ISO 8601 - Format.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
Kehrt zurück	string Beispiel: "2016-12-29T00:00:00.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

endzeit

Event Endzeit, in ISO 8601 - Format.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
Kehrt zurück	string Beispiel: "2016-12-29T00:00:00.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

urls_expire_time

Zeitstempel, in ISO 8601 - Format, das identifiziert , der Ablauf dieser ereignisbezogene URLs:

• last_event/web_url
• last_event/app_url
• last_event/image_url
• last_event/animated_image_url

Ablaufzeit wird wie folgt berechnet: last_event/start_time + n Tage (wobei n = 10 oder 30 Tage, je nach dem Nest Aware Zeichnungsplan ).

Benötigt Nest Aware .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
Kehrt zurück	string Beispiel: "2016-12-29T00:00:00.000Z"
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

web_url

Web URL (Deeplink) bis zum letzten Ton oder Bewegungsereignis bei home.nest.com . Wird verwendet, um das letzte aufgezeichnete Ereignis anzuzeigen, und erfordert, dass der Benutzer beim Konto angemeldet ist.

Benötigt Nest Aware . Wenn die Ereignis-URL abgelaufen ist oder das Gerät kein aktives Abonnement hat, wird dieser Wert nicht in die Nutzlast aufgenommen.

Siehe last_event/urls_expire_time für Informationen über die Ablaufzeit der URL.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
Kehrt zurück	string Beispiel: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

app_url

Nest App-URL (Deep Link) zum letzten Ton- oder Bewegungsereignis. Wird verwendet, um das letzte aufgezeichnete Ereignis anzuzeigen, und erfordert, dass der Benutzer beim Konto angemeldet ist.

Benötigt Nest Aware . Wenn die Ereignis-URL abgelaufen ist oder das Gerät kein aktives Abonnement hat, wird dieser Wert nicht in die Nutzlast aufgenommen.

Siehe last_event/urls_expire_time für Informationen über die Ablaufzeit der URL.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
Kehrt zurück	string Beispiel: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben / v1-v3 Kamera lesen/schreiben + Bilder / v1-v4

Bild URL

URL (Link) zur Bilddatei, die für ein Ton- oder Bewegungsereignis aufgenommen wurde.

Benötigt Nest Aware . Siehe last_event/urls_expire_time für Informationen über die Ablaufzeit der URL.

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
Kehrt zurück	string Beispiel: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben + Bilder / v1-v4

animierte_image_url

URL (Link) zur GIF-Datei, die für ein Ton- oder Bewegungsereignis aufgenommen wurde.

Benötigt Nest Aware .

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
Kehrt zurück	string Beispiel: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v1-v4 Kamera lesen/schreiben + Bilder / v1-v4

Activity_zone_ids

Bezeichner für Aktivitätszonen, die ein Bewegungsereignis erkannt haben.

Benötigt Nest Aware . Wenn es mit der verwendeten activity_zones Array können Sie die Zonennamen aus dieser IDs erhalten.

Wenn last_event/has_motion heißt

• true = gibt die Aktivitätszone IDs , die ein Bewegungsereignis detektiert
• false = gibt eine leere Array

Einzelheiten
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Kehrt zurück	array Beispiel: [ string1 , string2 ,... ]
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4