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
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. |
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 &, |
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:
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 &, |
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 &, |
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.
true
= gibt die Alarmbereiche-IDs zurück, die ein Bewegungsereignis erkannt habenfalse
= 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 |