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ückgabestring
Beispiel: "awJo6rH..."
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: &4t;4&0
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: &qtFabWH21nw..."
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: &d6reb_OZTM..."
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: &Flur;
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: &Flur;
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: Nest Cam (Flur) (Erdgeschoss)
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
Accesslesen/schreiben
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "2016-12-29T18:42:00.000Z"
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "https://home.nest.com/cameras/device_id?auth=camera_token
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "nestmobile://cameras/device_id?auth=camera_token
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabearray
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.
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
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.
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: string1/device_id/string2?auth=camera_token&
,
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabeboolean
Werte: true, false
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "2016-12-29T00:00:00.000Z"
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "2016-12-29T00:00:00.000Z"
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "2016-12-29T00:00:00.000Z"
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token&
,
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabestring
Beispiel: https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token&
,
AccessSchreibgeschützt
Verfügbar inKamera 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ückgabearray
Beispiel: [ string1, string2,... ]
AccessSchreibgeschützt
Verfügbar inKamera lesen + Bilder / v3-v4
Kamera lesen/schreiben + Bilder / v3-v4