Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

L'architecture de l'API Nest

À propos du service Nest

Les applications Nest permettent aux utilisateurs de se connecter à leur domicile où qu'ils se trouvent. Tous les appareils Nest (thermostats, protecteurs et caméras) et applications (iOS, Android et applications Web) se connectent au service Nest.

Exemple de cloud à cloud

Le service Nest fournit un modèle de données de la maison. Les appareils et applications lisent ce modèle de données pour prendre les mesures appropriées. Ils mettent à jour le modèle de données pour refléter les changements dans le système.

Par exemple, un thermostat lit sa température cible à partir du modèle de données. Il règle la température ambiante sur sa mesure actuelle et envoie les données du capteur à la fonction Chez moi / Absent, qui ajuste le mode structure en conséquence.

Les appareils Nest fonctionnent dans des environnements contraints. La puissance est limitée et la connectivité du réseau domestique peut ne pas être fiable. Vos produits et services peuvent tirer parti de nos algorithmes d'appareils pour offrir aux utilisateurs une expérience domestique simple et intuitive.

Le modèle de données

L'API Nest est représentée sous la forme d'un document JSON avec des attributs de premier niveau de metadata , d' devices et de structures . Vos produits Works with Nest utilisent ce document JSON pour interagir avec les appareils Nest et les changements d’état associés et y réagir.

Les structures nid représentent des structures physiques dans le monde réel. Ils servent de point d'organisation pour les devices et stockent des données pour le bâtiment dans son ensemble. En règle générale, une structure est un foyer d'utilisateurs.

Les devices Nest représentent les appareils physiques (thermostats, protecteurs et caméras) au sein d'une structure.

Chaque élément de données du document JSON est adressable par URL (également appelé «emplacements de données»). Les produits Works with Nest peuvent lire et écrire dans des sections de ce document et souscrire aux modifications. Cette fonctionnalité d'abonnement permet aux produits Works with Nest de réagir en temps réel aux modifications apportées au système, telles que la désactivation des lumières lorsqu'un utilisateur définit la structure sur Absent.

Les objets fonctionnent également sous des contraintes du monde réel. Le modèle de données protège les appareils et le domicile de l'utilisateur en évitant les actions surprenantes et dangereuses. Par exemple, le thermostat ne fait pas fonctionner le climatiseur lorsque le chauffage d'urgence est activé.

Explorez le modèle de données avec cette référence API interactive .

État prévu

Le service Nest stocke l’état faisant autorité du système et les produits Works with Nest s’abonnent aux modifications. La modification de cet état (par exemple, pour changer la température cible d'un thermostat) amène le service à envoyer une notification de changement à tous les abonnés.

Étant donné que cette propagation a un certain retard et que les réseaux peuvent ne pas être fiables, l'état observé par un produit peut ne pas être l'état actuellement observé par d'autres produits ou le service. L'état est finalement synchronisé au fur et à mesure que les messages sont transmis entre divers produits.

Ce modèle de publication / abonnement orienté document fournit des interactions applicatives réactives.

Utiliser le service Nest

Pour accéder aux points de terminaison REST dans le service Nest, utilisez HTTPS dans votre produit. Il existe de nombreuses bibliothèques clientes tierces qui peuvent être utilisées à cette fin.

Autorisations et autorisation

Nous voulons permettre aux développeurs de créer des produits et des services qui améliorent les maisons, sans compromettre la confidentialité et la sécurité des utilisateurs. Toutes nos communications sont sécurisées et l'autorisation d'accéder aux données est toujours explicitement accordée par l'utilisateur. Pour plus d'informations, consultez la vue d'ensemble des autorisations .

L'autorisation est gérée par le protocole OAuth 2.0. Lorsqu'un utilisateur accepte de fournir l'accès au niveau d'autorisation demandé, Nest authentifie la demande et un jeton d'accès est accordé au demandeur. Ce jeton d'accès peut être utilisé pour accéder à l'API Nest et interagir avec les structures et les appareils de l'utilisateur.

L'octroi d'un jeton d'accès établit une relation de confiance entre un utilisateur, un produit Works with Nest et Nest. Les utilisateurs peuvent révoquer l'accès à tout moment.

Pour savoir comment autoriser une connexion à l'API Nest, consultez la présentation des autorisations .