Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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:

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:

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