O Google está comprometido em promover a equidade racial para as comunidades negras. Veja como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

A arquitetura da API Nest

Sobre o serviço Nest

Os aplicativos Nest permitem que os usuários se conectem à sua casa de onde quer que estejam. Todos os dispositivos Nest (termostatos, proteções e câmeras) e aplicativos (iOS, Android e aplicativos da web) se conectam ao serviço Nest.

Exemplo de nuvem para nuvem

O serviço Nest fornece um modelo de dados da casa. Os dispositivos e aplicativos são lidos neste modelo de dados para executar as ações apropriadas. Eles atualizam o modelo de dados para refletir as alterações no sistema.

Por exemplo, um termostato lê sua temperatura alvo no modelo de dados. Ele define a temperatura ambiente para sua medição atual e envia os dados do sensor ao Home / Away Assist, que ajusta o modo da estrutura de acordo.

Os dispositivos Nest operam em ambientes restritos. A energia é limitada e a conectividade da rede doméstica pode não ser confiável. Seus produtos e serviços podem aproveitar nossos algoritmos de dispositivos para oferecer aos usuários uma experiência doméstica simples e intuitiva.

O modelo de dados

A API do Nest é representada como um documento JSON com atributos de nível superior de metadata , devices e structures . Seus produtos Works with Nest usam este documento JSON para interagir e reagir a dispositivos Nest e alterações de estado relacionadas.

As structures ninhos representam structures físicas no mundo real. Eles servem como um ponto de organização para devices e armazenam dados para o edifício como um todo. Normalmente, uma structure é uma casa do usuário.

Os devices Nest representam devices físicos (termostatos, proteções e câmeras) dentro de uma estrutura.

Cada elemento de dados no documento JSON é endereçável por URL (também conhecido como "localizações de dados"). Trabalhos com produtos Nest podem ler e gravar em seções deste documento e assinar alterações. Esse recurso de assinatura permite que os produtos Works with Nest reajam em tempo real às alterações feitas no sistema, como desligar as luzes quando um usuário define a estrutura como Ausente.

Os objetos também funcionam sob restrições do mundo real. O modelo de dados protege os dispositivos e a casa do usuário, impedindo ações surpreendentes e perigosas. Por exemplo, o termostato não aciona o ar condicionado quando o calor de emergência está ativado.

Explore o modelo de dados com esta referência interativa da API .

Estado pretendido

O serviço Nest armazena o estado autoritário do sistema e os produtos Works with Nest assinam as alterações. A modificação desse estado (por exemplo, para alterar a temperatura alvo de um termostato) faz com que o serviço envie uma notificação de alteração a todos os assinantes.

Como essa propagação tem algum atraso e as redes podem não ser confiáveis, o estado observado por um produto pode não ser o estado atualmente observado por outros produtos ou pelo serviço. O estado é finalmente sincronizado à medida que as mensagens são transmitidas entre vários produtos.

Esse modelo de publicação / assinatura orientado a documentos fornece interações de aplicativos responsivas.

Usando o serviço Nest

Para acessar os pontos de extremidade REST no serviço Nest, use HTTPS em seu produto. Existem muitas bibliotecas clientes de terceiros que podem ser usadas para esse fim.

Permissões e autorização

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

A autorização é tratada pelo protocolo OAuth 2.0. Quando um usuário concorda em fornecer acesso ao nível de permissão solicitado, o Nest autentica a solicitação e um token de acesso é concedido ao solicitante. Esse token de acesso pode ser usado para acessar a API do Nest e interagir com as 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 produto Works with Nest e o Nest. Os usuários podem revogar o acesso a qualquer momento.

Para saber como autorizar uma conexão com a API Nest, consulte a Visão geral da autorização .