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. Activez un appareil Nest compatible à l'aide d'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 à Device Access

Avant de créer votre premier projet, vous devez vous inscrire à Device Access. L'inscription implique l'acceptation des conditions d'utilisation de l'API Google et du bac à sable Device Access, ainsi que l'application de frais uniques non remboursables (5 USD) 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'ils soient individuels ou souhaitant créer une offre commerciale.

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

Accéder à la Device Access console

Avertissement :Si vous travaillez pour une organisation, inscrivez-vous à l'aide d'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 Device Access console ne peut plus être modifiée. Vérifiez que vous êtes connecté à la bonne adresse e-mail avant de continuer.

Pour en savoir plus, consultez la page 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é à l'aide d'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.

Pour plus d'informations sur l'activation d'un appareil compatible, consultez les manuels de l'appareil.

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 devez disposer d'un projet Google Cloud.

Cliquez sur le bouton 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. Dans le champ URI de redirection autorisés, saisissez https://www.google.com. 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 les valeurs d'ID client OAuth 2.0 et de 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:

      • Vous devez indiquer un ID client OAuth valide pour le projet.
      • Un ID client OAuth doit être valide et unique pour un project. Il ne peut pas être partagé avec d'autres project.
   3. Activez ou désactivez des é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 activer la diffusion d'événements. En cas de doute, sélectionnez Désactiver. Vous pourrez toujours les activer ultérieurement.
3. Une fois l'opération terminée, un ID de projet est attribué à votre projet, sous la forme d'un UUID, tel que 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Notez cet ID, car 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.