Commencer

Le programme Device Access permet aux utilisateurs d'accéder aux appareils Google Nest, de les contrôler et de les gérer à l'aide de l'API SDM.

Pour commencer à utiliser Device Access, vous devez effectuer les tâches suivantes:

1. Inscrivez-vous au programme Device Access .
2. Activer un appareil Nest compatible avec un compte Google
3. Créez un projet Google Cloud pour activer l'API SDM et obtenir un ID client OAuth 2.0.
4. Créez un projet Device Access pour recevoir un ID de projet.

S'inscrire au programme Device Access

Avant de créer votre premier projet, vous devez vous inscrire à Device Access. L'inscription nécessite l'acceptation des conditions d'utilisation de l'API Google et de Device Access Sandbox, ainsi que de frais uniques non remboursables (5 $) par compte.

Vous ne pourrez pas créer de projet tant que vous n'aurez pas accepté les deux conditions d'utilisation et payé les frais d'inscription. Cela s'applique à tous les utilisateurs, qu'il s'agisse de particuliers ou de personnes souhaitant créer une offre commerciale.

Inscrivez-vous dans la Device Access console, si ce n'est pas déjà fait:

Accéder à la Device Access console

Avertissement :Si vous travaillez pour une organisation, enregistrez-vous en utilisant une adresse e-mail d'équipe générique plutôt qu'une adresse e-mail personnelle ou individuelle. Une fois le compte créé, l'adresse e-mail de la console Device Access ne peut pas être modifiée. Assurez-vous d'être connecté à la bonne adresse e-mail avant de continuer.

Pour en savoir plus, consultez Device Access Inscription.

Activer un appareil compatible

Les appareils suivants sont compatibles avec le programme Device Access :

• Tous les thermostats Google Nest
• Toutes les caméras Google Nest
• Toutes les sonnettes Google Nest Doorbell
• Google Nest Hub Max

Consultez la page Appareils compatibles pour obtenir la liste des modèles d'appareils individuels.

Remarque :Un appareil compatible doit être activé avec un compte Google. Les anciens comptes Nest ne sont pas compatibles avec Device Access. Pour en savoir plus sur la migration d'un ancien compte Nest, consultez les questions fréquentes sur les comptes dans l'application Nest.

Consultez les manuels d'utilisation pour savoir comment activer votre appareil compatible.

Configurer Google Cloud Platform

L'accès à l'API SDM est fourni via Google Cloud. Pour activer l'API et autoriser un compte Google avec un appareil Nest compatible, vous avez besoin d'un projet Google Cloud.

Utilisez le bouton Enable the API and get an OAuth 2.0 Client ID (Activer l'API et obtenir un ID client OAuth 2.0) ci-dessous pour activer l'API Smart Device Management et obtenir un ID client OAuth 2.0:

1. Si vous souhaitez utiliser un projet Google Cloud existant pour Device Access, assurez-vous d'abord d'être connecté au compte administrateur de ce projet. Sélectionnez ensuite le projet existant dans la liste des projets disponibles après avoir cliqué sur le bouton. Sinon, créez un nouveau projet.
2. Sélectionnez Web Server (Serveur Web) lorsque le message "D'où appelez-vous ?" s'affiche.
3. Saisissez https://www.google.com dans le champ URI de redirection autorisés. Un URI de redirection est nécessaire pour obtenir un code d'autorisation à l'aide de PCM.
4. Une fois la configuration terminée, copiez l'ID client OAuth 2.0 et le code secret du client, puis téléchargez le fichier JSON des identifiants sur votre ordinateur local.

Activer l'API et obtenir un ID client OAuth 2.0

Si vous souhaitez configurer manuellement votre projet Google Cloud, ou vérifier la configuration et récupérer à nouveau vos identifiants:

1. Activez l'API Smart Device Management sur la page Activation de l'API.
2. Obtenez un ID client OAuth 2.0 sur la page Identifiants.

Créer un projet Device Access

Revenez à la Device Access console.

1. Sur l'écran d'accueil de la console, sélectionnez Créer un projet.
2. Remplissez chaque écran du processus de création :
   1. Saisissez le nom de votre projet.
   2. Saisissez l'ID client OAuth 2.0 généré lors de la configuration de Google Cloud Platform. Si vous n'avez pas copié votre ID client OAuth précédemment, vous le trouverez dans le fichier credentials.json que vous avez téléchargé.
      Remarque:Pour utiliser un projet avec l'API SDM, procédez comme suit:

      • Vous devez spécifier un ID client OAuth valide pour le projet.
      • Un ID client OAuth doit être valide et unique pour un project, et ne peut pas être partagé avec d'autres project.
   3. Activez ou désactivez les événements. Les événements sont gérés par Google Cloud Pub/Sub et fournissent des mises à jour asynchrones pour tous les appareils et toutes les structures autorisés pour votre projet. Sélectionnez Activer si vous souhaitez créer des événements. En cas de doute, sélectionnez Désactiver. Vous pourrez les activer plus tard.
3. Une fois l'opération terminée, votre projet reçoit un ID de projet, sous la forme d'un UUID, tel que 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Notez cet ID, vous en aurez besoin pour tous les appels d'API SDM.

Cet ID de projet est utilisé dans les appels OAuth et d'API. Il est spécifique à votre projetDevice Access et n'est pas lié à un ID de projet Google Cloud.