Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Estructura

Estructuras

Las estructuras de nido representan estructuras físicas en el mundo real. Por lo general, el hogar de un usuario, sirven como un punto de organización para dispositivos y almacenan datos que se aplican a todo el hogar.

Nest API proporciona acceso a los siguientes datos de nivel de estructura, dependiendo del nivel de permisos otorgados:

  • Nombre de la estructura y dispositivo "nombre del lugar" (ubicación en el hogar)
  • La lista de dispositivos en el hogar.
  • Estado del evento energético ( hora pico de energía )
  • Estado ausente
  • Usuario ETA
  • Estado de seguridad
  • codigo postal

Algunas características de nivel de estructura están cubiertas en guías API separadas y más detalladas:

Permisos de estructura

Para acceder a ... Seleccione...
La mayoría de los valores de datos en el objeto de structures Permisos de Away , ETA , Energía o Código postal
El valor de datos de name en el objeto de structures Estructura de permiso de lectura / escritura

Vea cómo funcionan los permisos en la Referencia interactiva de la API .

Identificadores de estructura

Nombre

El nombre de la estructura por defecto es "Inicio" pero puede ser cualquier cadena que el usuario elija. Cuando elige el permiso de lectura / escritura de Estructura , puede cambiar el name la estructura.

Wheres

wheres es un conjunto de objetos en una estructura, que contiene identificadores where_id ( where_id y name ). Utilice wheres para crear nombres de wheres personalizados o acceda a nombres de ubicación estándar.

El acceso al objeto wheres requiere permisos de cámara , humo + alarma de CO o termostato .

where_id

  • Un identificador único generado por Nest que representa el name
  • where_id es de solo lectura y se crea automáticamente en la llamada para crear un name personalizado donde

name

  • El nombre para mostrar del dispositivo; puede ser cualquier nombre de sala de una lista que proporcionamos, o un nombre personalizado
  • Para crear un name ubicación personalizado, realice una llamada POST para escribir un nuevo name ubicación personalizado; where_id se devuelve en la llamada
  • Consideraciones
    • name no se puede editar o eliminar después de la creación
    • name debe ser único dentro de la estructura
    • Si un dispositivo está emparejado con una estructura, la personalización donde el name asociado con el dispositivo es accesible desde las /structures/ ruta
    • Para mover un dispositivo con un name de usuario personalizado a una estructura diferente, desvincule el dispositivo y luego vuelva a emparejar el dispositivo con el nombre deseado

Obtén más información sobre los nombres de Nest Thermostats , Nest Protects y Nest Cams .

Otros metadatos

Todos los valores de datos son de solo lectura, a menos que se especifique lo contrario.

Valor de los datos Descripción
structure_id Una cadena que representa de forma única esta estructura. Cada desarrollador verá una ID diferente para la misma estructura, pero varios productos del mismo desarrollador verán la misma ID
country_code Un código de país ISO 3166-1 alfa-2 que se asigna a la ubicación registrada de la estructura
postal_code Código postal o postal, según el país
time_zone Una cadena de zona horaria de IANA que se asigna a la zona horaria de la estructura

Características de la estructura

Estados de alarma de humo y CO

Cuando elige el permiso de lectura Smoke + CO , puede acceder a smoke_alarm_state y co_alarm_state en el objeto de structures . Estos mismos valores de datos también están disponibles en el objeto del dispositivo ( devices/smoke_co_alarms ).

Consulte la guía de alarmas Smoke + CO para obtener más información sobre estos estados.

Muchos valores de datos trabajan juntos para determinar cómo se comportan los dispositivos en una estructura.

  • Cuando un estado de estructura away se establece como away la palabra "ECO" se muestra en el termostato Nest, en el idioma preferido del usuario
  • Cuando un estado de estructura away se establece en away , puede:
    • establecer fan_timer_active
    • cambiar target_temperature_f o target_temperature_c
  • Cuando un estado de estructura away se establece en home , puede:
    • hacer una llamada ETA (establecer id de viaje y ventana de llegada)
  • Cuando el apagado de emergencia está activo, no puede configurar fan_timer_active
  • Cuando el Calor de emergencia está habilitado, no puede establecer la estructura como away

Estructuras múltiples

Es posible que un usuario tenga más de una estructura adjunta a su cuenta Nest, por lo que su producto debe ofrecer un medio para que el usuario elija entre las estructuras disponibles (un selector de estructura).

Selector de estructura

Por ejemplo, al configurar ETA, es importante que el usuario pueda elegir una estructura para el destino de ETA. De manera similar, un usuario podría tener dos detectores de humo en la "sala" de dos casas diferentes. Si necesita hacer una correlación de estructura con su propio concepto de hogar, le recomendamos que lo haga durante el proceso de autorización.

Aprenda cómo los usuarios administran dispositivos en múltiples estructuras .

Máximos de dispositivo

Existen límites para la cantidad de dispositivos que Nest admite en una estructura.

Tipo de dispositivo Max por estructura
Termostato Nest 20
Cámaras Nido 10
Nest Protect 18 años

Error de mensajes

Para obtener información sobre qué significan los errores de llamadas de API y cómo manejarlos, consulte Mensajes de error .