Notice: We're retiring Works with Nest. See the home page for more information.

Diese Seite wurde von der Cloud Translation API übersetzt.

Camera API

Die Nest API ist mit allen Nest CamTM-Modellen kompatibel.

Nutzer können der Gruppe devices/cameras mehrere Nest Cams hinzufügen (maximal die maximale Anzahl pro Struktur). Wenn du diesen Datenstandort aufrufst, kannst du auf Nest Cam-Daten (Datenwerte für Geräte in der Struktur) zugreifen.

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

Geräte-ID

Eindeutige Kennung der Nest Cam

Details
`https://developer-api.nest.com/devices/cameras/device_id/device_id`
Rückgabe	`string` Beispiel: "awJo6rH..."
Access	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

Details
`https://developer-api.nest.com/devices/cameras/device_id/software_version`
Rückgabe	`string` Beispiel: &4t;4&0
Access	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 ID für die Struktur

Details
`https://developer-api.nest.com/devices/cameras/device_id/structure_id`
Rückgabe	`string` Beispiel: &qtFabWH21nw..."
Access	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_id

Eine eindeutige von Nest generierte ID, die name darstellt, den angezeigten Namen des Geräts.

Weitere Informationen über die Namen von Nest Thermostaten, Nest Protect-Geräten und Nest Cams

Details
`https://developer-api.nest.com/devices/cameras/device_id/where_id`
Rückgabe	`string` Beispiel: &d6reb_OZTM..."
Access	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 angezeigte Name des Geräts. Das ist mit der Nest Cam where_id verknüpft. Es kann sich um einen beliebigen Raumnamen aus einer von uns bereitgestellten Liste oder einen benutzerdefinierten Namen handeln. Weitere Informationen über die Namen von Nest Thermostaten, Nest Protect-Geräten und Nest Cams

Details
`https://developer-api.nest.com/devices/cameras/device_id/where_name`
Rückgabe	`string` Beispiel: &Flur;
Access	Schreibgeschützt
Verfügbar in	Kamera lesen / v3 Kamera lesen + Bilder / v4 Kamera lesen/schreiben / v3 Kamera lesen/schreiben + Bilder / v4

name

Angezeigter Name des Geräts. Ein beliebiger Raumname aus einer bereitgestellten Liste oder ein benutzerdefinierter Name.

Details
`https://developer-api.nest.com/devices/cameras/device_id/name`
Rückgabe	`string` Beispiel: &Flur;
Access	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_Lang

Langer Anzeigename des Geräts. Enthält ein benutzerdefiniertes Label (Label), das vom Nutzer oder über wheres erstellt wurde.

Details
`https://developer-api.nest.com/devices/cameras/device_id/name_long`
Rückgabe	`string` Beispiel: Nest Cam (Flur) (Erdgeschoss)
Access	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

Verbindungsstatus des Geräts beim Nest-Dienst.

Details
`https://developer-api.nest.com/devices/cameras/device_id/is_online`
Rückgabe	`boolean` Werte: true, false
Access	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_Streaming

Kamerastatus, entweder „Ein/aus“ oder „Streaming“. Weitere Informationen findest du unter So funktioniert deine Kamera mit der Zuhause/Abwesend-Funktion.

Details
`https://developer-api.nest.com/devices/cameras/device_id/is_streaming`
Rückgabe	`boolean` Werte: true, false
Access	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

ist_audio_input_enabled

Mikrofonstatus beim Kamera – entweder ein- und ausgeschaltet. Weitere Informationen zu den Audioeinstellungen von Nest Cam findest du hier.

Details
`https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled`
Rückgabe	`boolean` Werte: true, false
Access	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

Letzter_ist_online_change

Zeitstempel, der die letzte Änderung des Onlinestatus im ISO 8601-Format angibt

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change`
Rückgabe	`string` Beispiel: "2016-12-29T18:42:00.000Z"
Access	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

Abostatus des Nest Aware-Abos (Abo aktiv oder nicht).

Details
`https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled`
Rückgabe	`boolean` Werte: true, false
Access	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-Videostream unter home.nest.com

Details
`https://developer-api.nest.com/devices/cameras/device_id/web_url`
Rückgabe	`string` Beispiel: "`https://home.nest.com/cameras/device_id?auth=camera_token`
Access	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]

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

Details
`https://developer-api.nest.com/devices/cameras/device_id/app_url`
Rückgabe	`string` Beispiel: "`nestmobile://cameras/device_id?auth=camera_token`
Access	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

Die Nutzer können ihr Video teilen und es für jeden sichtbar machen. Wenn die öffentliche Freigabe aktiviert ist, können Sie public_share_url lesen.

Details
`https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled`
Rückgabe	`boolean` Werte: true, false
Access	Schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4

Alarmbereiche

Gibt ein Array aller definierten Alarmbereiche zurück

Alarmbereiche werden verwendet, um Bewegungsereignisse in benutzerdefinierten Bereichen des Videostreams zu überwachen. Dafür ist Nest Aware erforderlich.

Details
`https://developer-api.nest.com/devices/cameras/device_id/activity_zones`
Rückgabe	`array` Beispiel: `[ {"name" : "string1", "id" : "string2"},... ]` • `string1` ist der Zonenname, der entweder vom Nutzer definiert oder automatisch beim Erstellen der Zone generiert wird. • `string2` ist eine Kennung, die von Nest beim Erstellen des Alarmbereichs zugewiesen wird.
Access	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 Nutzer seinen Videostream öffentlich macht.

Details
`https://developer-api.nest.com/devices/cameras/device_id/public_share_url`
Rückgabe	`string` Beispiel: `https://video.nest.com/live/string1?string2`& t ist der Name des Videostreams. Er ist entweder benutzerdefiniert oder wird automatisch generiert, wenn der Stream auf „Öffentlich“ gesetzt ist. Achtung`string2` wird für den API-Aufruf verwendet. Ändern Sie den String nicht, sonst schlägt der Aufruf fehl.
Access	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 erfasst wurde. Die Kamera muss eingeschaltet und aktiv gestreamt werden.

Mit diesem Feld können Sie eine Momentaufnahme aus dem Live-Videostream abrufen.

snapshot_url: Gibt die URL eines Bildes zurück, das aus dem Live-Videostream aufgenommen wurde.
Die Kamera muss eingeschaltet sein und aktiv streamen.

Die Snapshot-Qualität über die API beträgt nur unter folgenden Bedingungen 1.080p-Durchsatz:

Kamerastream in der App aktiv aufrufen (web_url)
Öffentlicher Stream wird aufgerufen (app_url)
Nest Aware-Abo

Wenn du dir den Stream nicht aktiv ansiehst oder du kein Nest Aware-Abo hast, verfügt die API über keine 1080p-Quelle, von der ein Snapshot mit dieser Auflösung abgerufen wird, und es wird ein Bild mit geringerer Qualität erstellt. Eine geringe lokale Netzwerkbandbreite kann außerdem dazu führen, dass die Auflösung des API-Snapshots unter 1.080p sinkt, wenn Nest Aware vorhanden ist.

Weitere Informationen zu den Bandbreitenanforderungen für Nest-Kameras

Für diesen Anruf gelten Ratenbegrenzungen, je nach dem Abostatus von Nest Aware.

Details
`https://developer-api.nest.com/devices/cameras/device_id/snapshot_url`
Rückgabe	`string` Beispiel: `string1/device_id/string2?auth=camera_token`& , Achtung`string1` und `string2` werden für den API-Aufruf verwendet. Ändern Sie keinesfalls den Aufruf, da andernfalls der Aufruf fehlschlägt.
Access	Schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder/v3-v4

letztes_ereignis

Dieses Objekt erfasst Informationen zum letzten Ereignis, das eine Benachrichtigung ausgelöst hat.

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

Alle der folgenden Werte finden Sie im JSON-Dokument unter jedem devices/cameras/device_id/last_event.

wurde_sound

Geräuschereignis – Ton wurde erkannt.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound`
Rückgabe	`boolean` Werte: true, false
Access	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_Bewegung

Bewegungsereignis – Bewegung wurde erkannt.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion`
Rückgabe	`boolean` Werte: true, false
Access	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.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person`
Rückgabe	`boolean` Werte: true, false
Access	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

start_time

Beginn der Veranstaltung im ISO 8601-Format.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time`
Rückgabe	`string` Beispiel: "2016-12-29T00:00:00.000Z"
Access	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

Ereignisende im ISO 8601-Format.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time`
Rückgabe	`string` Beispiel: "2016-12-29T00:00:00.000Z"
Access	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 im ISO 8601-Format, der den Ablauf dieser ereignisbezogenen URLs angibt:

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

Die Ablaufzeit wird so berechnet: last_event/start_time + n Tage, wobei n = 10 oder 30 Tage ist, je nach dem Nest Aware-Abo.

Dafür ist Nest Aware erforderlich.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time`
Rückgabe	`string` Beispiel: "2016-12-29T00:00:00.000Z"
Access	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 letzten Geräusch- oder Bewegungsereignis auf home.nest.com. Wird zum Anzeigen des letzten aufgezeichneten Ereignisses verwendet und erfordert, dass der Nutzer im Konto angemeldet ist.

Dafür ist Nest Aware erforderlich. Wenn die Ereignis-URL abgelaufen ist oder das Gerät kein aktives Abo hat, ist dieser Wert nicht in der Nutzlast enthalten.

Unter last_event/urls_expire_time findest du Informationen zur Ablaufzeit der URL.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url`
Rückgabe	`string` Beispiel: "`https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token`
Access	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]

Nest App-URL (Deeplink) zum letzten Geräusch- oder Bewegungsereignis. Wird zum Anzeigen des letzten aufgezeichneten Ereignisses verwendet und erfordert, dass der Nutzer im Konto angemeldet ist.

Dafür ist Nest Aware erforderlich. Wenn die Ereignis-URL abgelaufen ist oder das Gerät kein aktives Abo hat, ist dieser Wert nicht in der Nutzlast enthalten.

Unter last_event/urls_expire_time findest du Informationen zur Ablaufzeit der URL.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url`
Rückgabe	`string` Beispiel: "`nestmobile://cameras/device_id/cuepoints/string?auth=camera_token`
Access	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 Geräusch- oder Bewegungsereignis erfasst wurde.

Dafür ist Nest Aware erforderlich. Unter last_event/urls_expire_time findest du Informationen zur Ablaufzeit der URL.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url`
Rückgabe	`string` Beispiel: `https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token`& , Achtung`string1` und `string2` werden für den API-Aufruf verwendet. Ändern Sie keinesfalls den Aufruf, da andernfalls der Aufruf fehlschlägt.
Access	Schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / V1-V4 Kamera lesen/schreiben + Bilder/V1-V4

Animierte_Bild-URL

URL (Link) zur GIF-Datei, die für ein Geräusch- oder Bewegungsereignis erfasst wurde.

Dafür ist Nest Aware erforderlich.

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url`
Rückgabe	`string` Beispiel: `https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token`& , Achtung`string1` und `string2` werden für den API-Aufruf verwendet. Ändern Sie keinesfalls den Aufruf, da andernfalls der Aufruf fehlschlägt.
Access	Schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / V1-V4 Kamera lesen/schreiben + Bilder / V1-V4

Activity_zone_ids

Kennungen für Alarmbereiche, die ein Bewegungsereignis erkannt haben.

Dafür ist Nest Aware erforderlich. Bei Verwendung mit dem Array activity_zones können Sie den Zonennamen aus diesen IDs abrufen.

Wenn last_event/has_motion

true = gibt die Alarmbereiche-IDs zurück, die ein Bewegungsereignis erkannt haben
false = gibt ein leeres Array zurück

Details
`https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids`
Rückgabe	`array` Beispiel: `[ string1, string2,... ]`
Access	Schreibgeschützt
Verfügbar in	Kamera lesen + Bilder / v3-v4 Kamera lesen/schreiben + Bilder / v3-v4