Notice: We're retiring Works with Nest. See the home page for more information.
O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

A arquitetura da API Nest

Sobre o serviço Nest

aplicações ninho permitir que os usuários se conectem com a sua casa a partir de onde quer que estejam. Todos os dispositivos Nest (termostatos, protege e Câmaras) e aplicações (iOS, Android e aplicativos web) se conectar ao serviço Nest.

Exemplo nuvem-nuvem

O serviço Nest fornece um modelo de dados da casa. Dispositivos e aplicações ler a partir deste modelo de dados para tomar as medidas adequadas. Eles atualizar o modelo de dados para refletir as mudanças no sistema.

Por exemplo, um termostato lê a temperatura alvo do modelo de dados. Ele define a temperatura ambiente, para a sua medição de corrente, e envia os dados do sensor de Casa / Fora Assist, que ajusta o modo de estrutura em conformidade.

dispositivos ninho operar em ambientes restritos. Poder é limitado e conectividade de rede em casa pode não ser confiável. Seus produtos e serviços podem alavancar nossos algoritmos dispositivo para oferecer aos usuários uma maneira simples, casa experiência intuitiva.

O modelo de dados

A API Nest é representado como um documento JSON com atributos de alto nível de metadata , devices e structures . Suas trabalha com produtos Ninho usar este documento JSON para interagir com, e reagir a, dispositivos de ninho e mudanças de estado relacionados.

Nest structures representam estruturas físicas do mundo real. Eles servem como um ponto de organização para devices e armazenar dados para a construção como um todo. Tipicamente, uma structure é uma casa do utilizador.

Nest devices representam dispositivos físicos (termostatos, protege, e Câmaras) dentro de uma estrutura.

Cada elemento de dados no documento JSON é endereçável por URL (também conhecido como "locais de dados"). Trabalha com produtos Nest pode ler e escrever para as seções deste documento e assinar alterações. Esta capacidade de assinatura permite que trabalha com produtos ninho para reagir em tempo real às mudanças feitas no sistema, tais como desligar as luzes quando um usuário define a estrutura para Ausente.

Objetos também trabalho sob restrições do mundo real. dispositivos do modelo de dados salvaguardas e home do usuário, impedindo ações surpreendentes e perigosas. Por exemplo, o termostato não executar o ar condicionado quando o calor de emergência está activado.

Explorar o modelo de dados com este Referência API interativa .

estado destina

Os serviços Nest armazena o estado autoritário do sistema, e trabalha com produtos Ninho subscrever alterações. Modificando este estado (por exemplo, para alterar a temperatura alvo de um termostato) faz com que o serviço para empurrar uma notificação de alteração para todos os assinantes.

Porque esta propagação tem algum atraso e redes podem não ser confiáveis, o estado observado por um produto pode não ser o estado observado atualmente por outros produtos ou o serviço. Estado é eventualmente sincronizadas como as mensagens são transmitidas entre vários produtos.

Este documento-oriented publish / subscribe modelo proporciona interações de aplicações sensíveis.

Usando o serviço Nest

Para acessar os terminais REST no serviço Nest, use HTTPS em seu produto. Existem muitas bibliotecas de cliente de terceiros que podem ser usados ​​para este fim.

Permissões e autorizações

Queremos permitir que os desenvolvedores de produtos e serviços que tornam casas melhor construir, sem comprometer a privacidade do usuário e segurança. Todas as nossas comunicações são seguras, e permissão para acessar os dados é sempre explicitamente concedida pelo usuário. Para mais informações, consulte a Visão geral das permissões .

Autorização é tratado pelo protocolo OAuth 2.0. Quando um usuário concorda em fornecer acesso ao nível de permissão solicitada, Ninho autentica o pedido e um token de acesso é concedido ao solicitante. Esse token de acesso pode ser usado para acessar a API do ninho e interagir com estruturas e dispositivos do usuário.

A concessão de um token de acesso estabelece uma relação de confiança entre um usuário, um Trabalha com produtos Nest, e no Ninho. Os usuários podem revogar o acesso a qualquer momento.

Para aprender a autorizar uma conexão com a API Nest, consulte o Visão geral de Autorização .