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

Sécurité

Votre produit peut utiliser l'API Nest pour éviter les intrusions à domicile.

Lorsque tous les membres de la famille sont loin de chez eux, la structure passe away mode away . Lorsqu'une Nest Cam détecte une personne, le champ /last_event/has_person API Camera devient true .

Ces deux états fonctionnent ensemble pour déclencher l'API Works with Nest Security, comme suit:

Si une Nest Cam détecte la présence d'une personne alors que la structure est en mode away , la structure passe en mode deter .

Lorsque votre produit détecte que la structure est en mode deter , votre produit peut faire «faire semblant» d’occuper la maison en modifiant l’environnement domestique d’une manière ou d’une autre, par exemple en allumant les lumières, en jouant de la musique ou en ouvrant des stores pour faire un intrus plus visible.

De cette façon, la maison devient une cible moins invitante pour les attaques.

Exigences

Pour utiliser l'API de sécurité:

  • Votre client doit disposer de ces autorisations:
    Activer la fonction Chez moi / Absent
    • État de sécurité lu / v1
    • Structure lecture / écriture / v1
    • Lecture de la caméra / v3
  • L'état d' away structure doit être précis, c'est-à-dire:
    • Tous les occupants de la maison doivent être ajoutés en tant que membres de la famille dans l' application Nest .
    • Tous les membres de la famille doivent avoir installé l'application Nest sur leur téléphone avec la fonction Chez moi / Absent activée.
  • La structure doit comporter au moins une Nest Cam capable d'envoyer des alertes de personne . Pour certains modèles de Nest Cam, la Nest Cam doit disposer d'un abonnement Nest Aware pour recevoir des alertes de personne.

En savoir plus sur les alertes que les utilisateurs reçoivent des différents modèles de caméras .

Fonctions de sécurité

L'état de sécurité augmente pour deter lorsque les critères suivants sont remplis:

  • L'état de la structure est away .
  • La structure contient au moins une Nest Cam qui:
    • est en ligne et diffuse activement
    • déclenche un dernier événement où has_person = "true"

Un état deter est réévalué après plusieurs minutes et relâché à ok si aucun autre événement has_person ne s'est produit.

L'état de sécurité passe automatiquement à ok lorsque l'état de la structure est Home .

Un produit Works with Nest qui réagit à un état deter doit également réagir à la désescalade de cet état. Par exemple, les lumières et la musique qui s'allument pour simuler l'occupation dans un état deter devraient éventuellement s'éteindre après que www_security_state en ok .

Autorisations de sécurité

Pour utiliser l'API de sécurité, choisissez l'autorisation Lecture / v1 de l'état de la sécurité.

Aucune autorisation d'écriture n'est disponible pour l'API de sécurité.

Valeurs de sécurité

Utilisez le champ wwn_security_state pour afficher l'état de la sécurité.

Valeur La description
ok Fonctionnement normal, tout va bien dans la structure
deter Personne détectée alors que l'état de la structure est away