Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Seguridad

Su producto puede usar la API de Nest para ayudar a prevenir intrusiones en el hogar.

Cuando todos los miembros de la familia están fuera de casa, la estructura entra away modo away . Cuando una Nest Cam detecta a una persona, el campo /last_event/has_person la API de la cámara cambia a true .

Estos dos estados funcionan juntos para activar Works with Nest Security API, de la siguiente manera:

Si una Nest Cam detecta la presencia de una persona mientras la estructura está en modo away , la estructura entra en modo de deter .

Cuando su producto detecta que la estructura está en modo deter , su producto puede hacer que la casa "pretenda" estar ocupada al alterar el entorno del hogar de alguna manera, como encender las luces, reproducir música o abrir las persianas para hacer un intruso. más visible.

De esta manera, el hogar se convierte en un objetivo menos atractivo para el ataque.

Requisitos

Para utilizar la API de seguridad:

  • Su cliente debe tener estos permisos:
    Activar Asistente En casa / Ausente
    • Estado de seguridad leído / v1
    • Estructura lectura / escritura / v1
    • Lectura de cámara / v3
  • El estado de estructura away debe ser preciso, es decir:
    • Todos los ocupantes de la casa deben agregarse como miembros de la familia en la aplicación Nest .
    • Todos los miembros de la familia deben tener la aplicación Nest instalada en su teléfono con el Asistente En casa / Ausente habilitado.
  • La estructura debe tener al menos una Nest Cam capaz de enviar alertas de personas . Para algunos modelos de Nest Cam, la Nest Cam debe tener una suscripción a Nest Aware para recibir alertas de personas.

Obtenga más información sobre las alertas que reciben los usuarios de diferentes modelos de cámara .

Características de seguridad

El estado de seguridad aumenta para deter cuando se cumplen los siguientes criterios:

  • El estado de la estructura está away .
  • La estructura contiene al menos una Nest Cam que:
    • está en línea y transmitiendo activamente
    • desencadena un último evento donde has_person = "true"

Un estado de deter se vuelve a evaluar después de varios minutos y se relaja a ok si no se han producido más eventos has_person .

El estado de seguridad cambia automáticamente a ok cuando el estado de la estructura es Home .

Un producto Works with Nest que reacciona a un estado de deter también debería reaccionar a la disminución de ese estado. Por ejemplo, las luces y la música que se encienden para simular la ocupación en un estado de deter , eventualmente deberían apagarse después de que www_security_state a ok .

Permisos de seguridad

Para utilizar la API de seguridad, elija el permiso de lectura / v1 del estado de seguridad.

No hay permisos de escritura disponibles para la API de seguridad.

Valores de seguridad

Utilice el campo wwn_security_state para ver el estado de seguridad.

Valor Descripción
ok Funcionamiento normal, todo está bien en la estructura.
deter Persona detectada, mientras que el estado es la estructura away