Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

API de la caméra

L'API Nest fonctionne avec tous les modèles Nest Cam ™.

Les utilisateurs peuvent ajouter plusieurs Nest Cam au groupe d' devices/cameras , jusqu'au maximum par structure . Lorsque vous passez un appel vers cet emplacement de données, vous pouvez accéder aux données de la Nest Cam (valeurs de données pour les appareils de la structure).

Toutes les valeurs ci-dessous se trouvent sous chaque devices/cameras/ device_id dans le document JSON.

Reference de l'appareil

Identifiant unique de la Nest Cam.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Retour string
Exemple: "awJo6rH ..."
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

une version de logiciel

Une version de logiciel.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Retour string
Exemple: "4.0"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

structure_id

Identifiant unique de la structure.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Retour string
Exemple: "VqFabWH21nw ..."
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

where_id

Identifiant unique généré par Nest qui représente le name , le nom d'affichage de l'appareil.

En savoir plus sur les noms des thermostats Nest , des Nest Protect et des Nest Cam .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Retour string
Exemple: "d6reb_OZTM ..."
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

où_nom

Le nom d'affichage de l'appareil. Associé à la Nest Cam where_id . Il peut s'agir de n'importe quel nom de salle d'une liste que nous fournissons ou d'un nom personnalisé. En savoir plus sur les noms des thermostats Nest , des Nest Protect et des Nest Cam .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Retour string
Exemple: "Hallway"
Accès lecture seulement
Disponible en Lecture de la caméra / v3
Lecture caméra + images / v4
Lecture / écriture de la caméra / v3
Caméra lecture / écriture + images / v4

Nom

Afficher le nom de l'appareil; peut être n'importe quel nom de salle d'une liste que nous fournissons, ou un nom personnalisé.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /name
Retour string
Exemple: "Hallway"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

nom_long

Nom d'affichage long de l'appareil. Comprend une (étiquette) personnalisée, créée par l'utilisateur ou via des wheres .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Retour string
Exemple: "Nest Cam Hallway (à l'étage)"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

est en ligne

État de la connexion de l'appareil avec le service Nest.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

is_streaming

État de la caméra, activé et diffusé activement la vidéo, ou désactivé. Pour plus d'informations, consultez Comment votre caméra fonctionne avec la fonction Chez moi / Absent .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Retour boolean
Valeurs: vrai, faux
Accès lire écrire
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

is_audio_input_enabled

État du microphone de la caméra, soit activé et écoute, soit désactivé. En savoir plus sur les paramètres audio de la Nest Cam .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

last_is_online_change

Horodatage qui identifie la dernière modification de l'état en ligne, au format ISO 8601 .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
Retour string
Exemple: "2016-12-29T18: 42: 00.000Z"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

is_video_history_enabled

État de l' abonnement Nest Aware (abonnement actif ou non).

Détails
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

web_url

URL Web (lien profond) vers le flux vidéo en direct sur home.nest.com .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /web_url
Retour string
Exemple: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

app_url

URL de l'application (lien profond) vers le flux vidéo en direct dans l'application Nest.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /app_url
Retour string
Exemple: " nestmobile://cameras/ device_id ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

is_public_share_enabled

Les utilisateurs peuvent choisir de partager leur vidéo et de la rendre visible par tout le monde. Lorsque le partage public est activé, vous pouvez lire public_share_url .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture caméra + images / v3-v4
Caméra lecture / écriture + images / v3-v4

activity_zones

Renvoie un tableau de toutes les zones d'activité définies.

Les zones d'activité sont utilisées pour surveiller les événements de mouvement dans les zones définies par l'utilisateur du flux vidéo. Nécessite Nest Aware .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
Retour array
Exemple: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 est le nom de la zone, défini par l'utilisateur ou généré automatiquement lors de la création de la zone.
string2 est un identifiant attribué par Nest lors de la création de la zone d'activité.
Accès lecture seulement
Disponible en Lecture caméra + images / v3-v4
Caméra lecture / écriture + images / v3-v4

public_share_url

Vous pouvez accéder à cette URL lorsqu'un utilisateur rend son flux vidéo public .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Retour string
Exemple: " https://video.nest.com/live/ string1 ? string2 "

string1 est le nom du flux vidéo, défini par l'utilisateur ou généré automatiquement lorsque le flux est défini sur public.
Accès lecture seulement
Disponible en Lecture caméra + images / v3-v4
Caméra lecture / écriture + images / v3-v4

snapshot_url

Capturez une image à la demande. Renvoie l'URL d'une image capturée à partir du flux vidéo en direct. Nécessite que la caméra soit allumée et qu'elle diffuse activement.

Utilisez ce champ pour obtenir un instantané du flux vidéo en direct.

  • snapshot_url - renvoie l'URL d'une image capturée à partir du flux vidéo en direct
  • Nécessite que la caméra soit allumée et qu'elle diffuse activement

La qualité de l'instantané de l'API n'est que d'un débit de 1080p si vous êtes:

  • visualisation active du flux de la caméra dans l'application ( web_url )
  • affichage actif du flux public ( app_url )
  • abonné à Nest Aware

Si vous ne visualisez pas activement le flux ou si vous ne disposez pas d'un abonnement Nest Aware, l'API n'a pas de source 1080p à partir de laquelle récupérer un instantané à cette résolution et génère une image de qualité inférieure. En outre, une faible bande passante du réseau local peut faire chuter la résolution de l'instantané de l'API en dessous de 1080p avec Nest Aware présent.

En savoir plus sur les exigences de bande passante pour les caméras Nest .

Des limites de tarif s'appliquent à cet appel, en fonction de l' état de l'abonnement Nest Aware.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
Retour string
Exemple: " string1 / device_id / string2 ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture caméra + images / v3-v4
Caméra lecture / écriture + images / v3-v4

dernier événement

Cet objet capture des informations sur le dernier événement qui a déclenché une notification.

Certains champs et certaines combinaisons d'autorisations nécessitent un abonnement Nest Aware pour accéder aux informations du dernier événement.

Toutes les valeurs ci - dessous se trouvent sous chaque devices/cameras/ device_id /last_event dans le document JSON.

has_sound

Événement sonore - un son a été détecté.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

has_motion

Événement de mouvement - un mouvement a été détecté.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

has_person

Événement de personne - une personne a été détectée.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Retour boolean
Valeurs: vrai, faux
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

Heure de début

Heure de début de l'événement, au format ISO 8601 .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
Retour string
Exemple: "2016-12-29T00: 00: 00.000Z"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

heure de fin

Heure de fin de l'événement, au format ISO 8601 .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
Retour string
Exemple: "2016-12-29T00: 00: 00.000Z"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

urls_expire_time

Horodatage, au format ISO 8601 , qui identifie l'expiration de ces URL liées aux événements:

L'heure d'expiration est calculée comme last_event/start_time : last_event/start_time + n jours (où n = 10 ou 30 jours, selon le plan d'abonnement Nest Aware).

Nécessite Nest Aware .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
Retour string
Exemple: "2016-12-29T00: 00: 00.000Z"
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

web_url

URL Web (lien profond) vers le dernier événement sonore ou animé sur home.nest.com . Utilisé pour afficher le dernier événement enregistré et nécessite que l'utilisateur soit connecté au compte.

Nécessite Nest Aware . Si l'URL de l'événement a expiré ou si l'appareil n'a pas d'abonnement actif, cette valeur n'est pas incluse dans la charge utile.

Voir last_event/urls_expire_time pour plus d'informations sur l'heure d'expiration de cette URL.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
Retour string
Exemple: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

app_url

URL de l'application Nest (lien profond) vers le dernier événement sonore ou animé. Utilisé pour afficher le dernier événement enregistré et nécessite que l'utilisateur soit connecté au compte.

Nécessite Nest Aware . Si l'URL de l'événement a expiré ou si l'appareil n'a pas d'abonnement actif, cette valeur n'est pas incluse dans la charge utile.

Voir last_event/urls_expire_time pour plus d'informations sur l'heure d'expiration de cette URL.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
Retour string
Exemple: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture de la caméra / v1-v3
Lecture caméra + images / v1-v4
Lecture / écriture de la caméra / v1-v3
Caméra lecture / écriture + images / v1-v4

URL de l'image

URL (lien) vers le fichier image capturé pour un événement sonore ou animé.

Nécessite Nest Aware . Voir last_event/urls_expire_time pour plus d'informations sur l'heure d'expiration de cette URL.

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
Retour string
Exemple: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture caméra + images / v1-v4
Caméra lecture / écriture + images / v1-v4

animated_image_url

URL (lien) vers le fichier gif capturé pour un événement sonore ou animé.

Nécessite Nest Aware .

Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
Retour string
Exemple: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Accès lecture seulement
Disponible en Lecture caméra + images / v1-v4
Caméra lecture / écriture + images / v1-v4

activity_zone_ids

Identificateurs des zones d'activité qui ont détecté un événement de mouvement.

Nécessite Nest Aware . Lorsqu'il est utilisé avec le tableau activity_zones , vous pouvez obtenir le nom de la zone à partir de ces identifiants.

Si last_event/has_motion est

  • true = renvoie les identifiants de zone d'activité qui ont détecté un événement de mouvement
  • false = renvoie un tableau vide
Détails
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Retour array
Exemple: [ string1 , string2 ,... ]
Accès lecture seulement
Disponible en Lecture caméra + images / v3-v4
Caméra lecture / écriture + images / v3-v4