O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Referência da Nest API

A API Nest modela uma casa ou edifício físico como uma estrutura, com Nest Learning Thermostats, Nest Protects e Nest Cams como dispositivos na estrutura. Essa estrutura também contém informações sobre a casa como um todo (como Ausente ou ETA, ou horário de pico ativo).

Cada elemento de dados na estrutura é endereçável por um URL de recurso (chamado "locais de dados") em um documento JSON compartilhado. Cada local de dados pode armazenar strings, números, booleanos, objetos pai / filho ou matrizes.

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

Na API, você pode sincronizar dados de locais em vários níveis no modelo de dados, por exemplo:

  • uma estrutura inteira, incluindo todos os dispositivos
  • um único dispositivo em uma estrutura
  • um grupo de valores de dados (temperatura atual e ambiente)
  • um único valor de dados (estado de integridade da bateria)

Seus produtos devem responder com atenção a eventos como estes:

No entanto, lembre-se de que cada um dos objetos baseados em dispositivo está trabalhando sob restrições do mundo real. Por exemplo, o termostato não deve ligar o ar condicionado quando o aquecimento de emergência está ativado. Nossa API foi projetada para proteger nossos dispositivos e a casa do usuário e evitará certas ações se forem surpreendentes ou perigosas.

Permissões e dados compartilhados do dispositivo

A capacidade de ler ou gravar em um local de dados é controlada por permissões. Os grupos de permissão fornecem acesso de leitura, gravação ou leitura / gravação a valores de dados selecionados em dispositivos e estruturas.

Para mais informações, consulte o Visão geral das permissões .

Dados e privacidade

Os dados envolvidos com produtos domésticos podem ser muito pessoais. Os dados do sensor residencial contêm informações sobre como as pessoas vivem suas vidas em seu espaço pessoal. A segurança e o manuseio desses dados são muito importantes e um foco significativo na Nest. Deixamos bem claro para os usuários que tipo de dados temos, como são usados ​​e onde podem controlá-los.

Saiba mais sobre nossos pontos de vista sobre privacidade .

Metadados

Metadados são informações adicionais fornecidas quando você faz uma chamada para o endpoint de nível raiz:

https://developer-api.nest.com/

access_token

Após a autorização do usuário, seu produto usa um token de acesso para fazer chamadas de API para o serviço Nest. Este token de acesso serve como prova de que um usuário autorizou seu produto a fazer chamadas em seu nome.

Detalhes
Devoluções string
Exemplo: "c.FmDPkzyzaQe ..."

client_version

A versão do cliente é a última versão autorizada pelo usuário de um cliente, e está associada a um access_token .

Quando você atualiza as permissões para um cliente, a versão do cliente é incrementada e o usuário é notificado de que uma atualização está disponível. Seus usuários devem aceitar esta atualização do cliente antes de usar o produto atualizado.

Detalhes
Devoluções number
Exemplos: 1, 17, 42

ID do usuário

O ID do usuário permite que você identifique os usuários nas chamadas de API. Esse identificador é diferente para cada combinação de produto e usuário Works with Nest.

Por exemplo, se o utilizador tiver autorizado um Works com ninho produto A e trabalha com produto Nest B, em seguida, o produto A tem um user_id valor para o utilizador 1, e o produto B tem um diferente user_id valor para o utilizador 1.

Detalhes
Devoluções string
Exemplo: z.1.1.7DHps ...