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.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Détecteur de fumée + CO

Détecteur de fumée + CO

Nest Protect est conçu pour détecter la fumée et le monoxyde de carbone (CO) dans un environnement résidentiel, avec plusieurs capteurs pour l’aider à comprendre ce qui se passe dans la maison.

L' API Nest permet d'accéder aux données suivantes sur Nest Protect:

  • État d'alarme de fumée ou de monoxyde de carbone (CO)
  • État de santé de la batterie
  • Statut et horodatage du dernier test manuel
  • État en ligne et dernières informations de connexion
  • Nom de la structure et appareil "où nom" (emplacement dans la maison)

Autorisations Fumée + CO

Pour un accès en lecture à toutes les valeurs de données API d'alarme Smoke + CO, sélectionnez l'autorisation de lecture Smoke + CO pour votre client.

Aucune autorisation d'écriture n'est disponible pour l'API d'alarme Smoke + CO.

Identifiants de fumée + CO

Dispositif

Les appareils Nest sont répertoriés par type sous la forme d'un tableau d'identifiants, qui peuvent être utilisés pour identifier de manière unique un appareil via le chemin de l'appareil. Ainsi, un ID d'alarme fumée + co de "RTMTKxs..." signifie que vous pouvez charger le modèle d'appareil d'alarme fumée + co dans devices/smoke_co_alarms/RTMTKxs... via l'API.

Lorsqu'un appareil est connecté à plusieurs produits, chaque développeur verra un identifiant différent pour cet appareil. Pour un appareil qui a installé plusieurs produits du même développeur, le développeur verra le même ID.

Nom

Deux attributs de nom sont fournis. L'attribut de name plus court est affiché dans les étiquettes de l'interface utilisateur, tandis que name_long est utilisé dans le texte au name_long long.

name

Dans cet exemple, le name est "Nest Protect".

Nom

name_long

Dans cet exemple, name_long est "Basement Nest Protect".

Nom long

where_id

  • Un identifiant unique généré par Nest qui représente le name
  • where_id est en lecture seule et est créé automatiquement dans l'appel pour créer un name where personnalisé

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

where_name

Lorsque vous choisissez l' autorisation de lecture Smoke + CO , vous pouvez accéder au périphérique where_name partir de l'objet devices/smoke_co_alarms ( devices/smoke_co_alarms ).

Autres métadonnées

Toutes les valeurs de données sont en lecture seule, sauf indication contraire.

Valeur des données La description
locale La langue et le code de pays attribués à cet appareil
software_version Une chaîne qui représente le micrologiciel actuellement installé sur l'appareil
structure_id Une chaîne qui représente de manière unique cette structure; c'est la structure avec laquelle l'appareil est appairé
last_connection L'horodatage de la dernière connexion réussie au service Nest
is_online Statut en ligne. Ceci est déterminé par Nest à l’aide de l’heure last_connection et d’une fenêtre de reconnexion attendue propre à l’appareil.

Fonctionnalités Smoke + CO

Santé de la batterie

Utilisez le champ battery_health pour afficher l'état de santé de la batterie.

Valeur La description
ok Niveau de batterie ok
replace Niveau de batterie bas, doit être remplacé

Alarme CO

Utilisez le champ co_alarm_state pour afficher l'état de l'alarme CO.

Valeur La description
ok Fonctionnement normal
warning Détection de l'augmentation des niveaux de CO
emergency Niveaux de CO trop élevés, l'utilisateur doit quitter la maison

Détecteur de fumé

Utilisez le champ smoke_alarm_state pour afficher l'état du détecteur de fumée.

Valeur La description
ok Fonctionnement normal
warning Détection de l'augmentation des niveaux de fumée
emergency Niveaux de fumée trop élevés, l'utilisateur doit quitter la maison

Test manuel

Utilisez ces champs pour vérifier si un test manuel de fumée ou de CO est actuellement actif et la dernière fois qu'un test de fumée ou de CO réussi a été effectué.

État de la couleur de l'interface utilisateur

Pour faciliter la conception d’une interface utilisateur inter-produits cohérente, nous avons fourni le champ ui_color_state , qui donne une indication de haut niveau sur l’état général du Nest Protect. Il est dérivé de is_online , battery_health , co_alarm_state et smoke_alarm_state , fournissant une condition globale qui reflète les indicateurs de couleur réels affichés dans l' application Nest .

Messages d'erreur

Pour plus d'informations sur la signification des erreurs d'appel d'API et sur la manière de les gérer, consultez Messages d'erreur .