Kamera-API

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

Benutzer können der Geräte- devices/cameras Kameragruppe mehrere Nest- devices/cameras hinzufügen, maximal pro Struktur . Wenn Sie diesen Datenspeicherort anrufen, können Sie auf Nest Cam-Daten zugreifen (Datenwerte für Geräte in der Struktur).

Alle folgenden Werte finden Sie unter den devices/cameras/ device_id im JSON-Dokument.

Geräte ID

Nest Cam eindeutige Kennung.

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 gelesen / 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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

structure_id

Struktur eindeutiger Bezeichner.

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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

where_id

Eine eindeutige, von Nest generierte Kennung, die den name , den Anzeigenamen des Geräts, darstellt.

Erfahren Sie mehr darüber, wo Namen für Nestthermostate , Nestschutz und Nestkameras stehen .

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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

where_name

Der Anzeigename des Geräts. Verbunden mit der 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-Thermostate , Nest-Schutz und Nest-Kameras stehen .

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 gelesen / v3 Kamera lesen + Bilder / v4 Kamera lesen / schreiben / v3 Kamera lesen / schreiben + Bilder / v4

Name

Anzeigename des Geräts; Dies 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 gelesen / 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 eine benutzerdefinierte (Beschriftung), die vom Benutzer oder über wheres .

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

is_streaming

Kamerastatus, entweder ein und aktiv Video-Streaming oder aus. Weitere Informationen finden Sie unter Funktionsweise Ihrer Kamera mit Home / Away Assist .

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 gelesen / 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 hörend oder aus. Weitere Informationen zu den Audioeinstellungen von Nest Cam .

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 gelesen / 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 des Online-Status im ISO 8601- Format identifiziert.

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 gelesen / 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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

web_url

Web-URL (Deep Link) zum Live-Videostream unter 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 gelesen / 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 gelesen / 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 ihr Video freigeben und für jedermann sichtbar machen. Wenn die öffentliche Freigabe aktiviert ist, können Sie public_share_url lesen.

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

activity_zones

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

Aktivitätszonen werden verwendet, um Bewegungsereignisse in benutzerdefinierten Bereichen des Videostreams 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 der string1 , der entweder benutzerdefiniert ist oder beim string1 der Zone automatisch generiert wird. • string2 ist eine Kennung, die von Nest beim string2 der Aktivitätszone zugewiesen wird.
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen / schreiben + Bilder / v3-v4

public_share_url

Sie können auf diese URL zugreifen, wenn ein Benutzer seinen Videostream veröffentlicht .

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 Name des Videostreams, der entweder benutzerdefiniert oder automatisch generiert wird, wenn der Stream auf public gesetzt wird.
Zugriff	schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen / schreiben + Bilder / v3-v4

snapshot_url

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

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

• snapshot_url - Gibt die URL eines Bildes zurück, das aus dem Live-Videostream aufgenommen wurde
• Erfordert, dass die Kamera eingeschaltet ist und aktiv gestreamt wird

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

• web_url Anzeigen des Kamerastreams in der Anwendung ( web_url )
• aktiv den öffentlichen Stream app_url ( app_url )
• Nest Aware abonniert

Wenn Sie den Stream nicht aktiv anzeigen oder kein Nest Aware-Abonnement haben, verfügt die API über keine 1080p-Quelle, aus der ein Snapshot mit dieser Auflösung abgerufen werden kann, und generiert ein Bild mit geringerer Qualität. Eine geringe lokale Netzwerkbandbreite kann auch dazu führen, dass die API-Snapshot-Auflösung bei vorhandenem Nest Aware unter 1080p sinkt.

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 zum letzten Ereignis, das eine Benachrichtigung ausgelöst hat.

Für einige Felder und einige Berechtigungskombinationen ist ein Nest Aware- Abonnement erforderlich, um auf die Informationen zum letzten Ereignis zugreifen zu können.

Alle folgenden Werte finden Sie unter den 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 gelesen / 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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

has_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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

Startzeit

Ereignisstartzeit im ISO 8601- Format.

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

end_time

Ereignisendzeit im ISO 8601- Format.

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

urls_expire_time

Zeitstempel im ISO 8601- Format, der den Ablauf dieser ereignisbezogenen URLs identifiziert:

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

Die last_event/start_time wird wie folgt berechnet: last_event/start_time + n Tage (wobei n = 10 oder 30 Tage, abhängig vom Nest Aware- Abonnement ).

Benötigt Nest Aware .

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

web_url

Web-URL (Deep Link) zum letzten Sound- oder Bewegungsereignis unter home.nest.com . Wird verwendet, um das zuletzt 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, ist dieser Wert nicht in der Nutzlast enthalten.

Informationen zur last_event/urls_expire_time dieser URL finden Sie unter last_event/urls_expire_time .

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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

app_url

Verschachteln Sie die App-URL (Deep Link) zum letzten Sound- oder Bewegungsereignis. Wird verwendet, um das zuletzt 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, ist dieser Wert nicht in der Nutzlast enthalten.

Informationen zur last_event/urls_expire_time dieser URL finden Sie unter last_event/urls_expire_time .

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 gelesen / v1-v3 Kamera lesen + Bilder / v1-v4 Kamera lesen / schreiben / v1-v3 Kamera lesen / schreiben + Bilder / v1-v4

Bild URL

URL (Link) zu der Bilddatei, die für ein Ton- oder Bewegungsereignis erfasst wurde.

Benötigt Nest Aware . Informationen zur last_event/urls_expire_time dieser URL finden Sie unter last_event/urls_expire_time .

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_Bild_url

URL (Link) zu der GIF-Datei, die für ein Sound- oder Bewegungsereignis erfasst 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

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

Benötigt Nest Aware . Bei Verwendung mit dem Array activity_zones können Sie den Zonennamen aus diesen IDs abrufen.

Wenn last_event/has_motion ist

• true = gibt die Aktivitätszonen-IDs zurück, die ein Bewegungsereignis erkannt haben
• false = gibt ein leeres Array zurück

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