Débuter

Le Device Access programme permet aux utilisateurs d'accéder aux appareils Google Nest, ainsi que 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 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 Device Access projet pour recevoir un ID de projet.

S'inscrire à Device Access

Avant de créer votre premier projet, vous devez vous inscrire à Device Access. Pour vous inscrire, vous devez accepter les conditions d'utilisation de l'API Google et du bac à sable Device Access, et payer des frais uniques non remboursables (5$US) 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 des particuliers ou des entreprises 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 Vous devez utiliser un compte Google grand public (par exemple, un compte gmail.com) pour vous inscrire à Device Access. Vous ne pouvez pas utiliser de compte Google Workspace.

Si vous travaillez pour une organisation, nous vous suggérons de vous inscrire à Device Access à l'aide d'un compte pour votre équipe.Avertissement : Une fois qu'un compte Google est associé à votre projet Device Access, il ne peut plus être modifié. Assurez-vous d'être connecté au bon compte Google avant de continuer.

Pour en savoir plus, consultez la section Device Access Inscription pour plus d'informations.

Activer un appareil compatible

Les appareils suivants sont compatibles avec le Device Access programme :

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

Pour obtenir la liste des modèles d'appareils individuels, consultez la page Appareils compatibles.

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.

Pour savoir comment activer votre appareil compatible, consultez son manuel.

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 aurez besoin 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 disposez déjà d'un projet Google Cloud que vous souhaitez utiliser 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 projet.
2. Sélectionnez Serveur Web lorsque vous êtes invité à indiquer d'où vous appelez.
3. Saisissez https://www.google.com comme valeur pour URI de redirection autorisés. Un URI de redirection est requis pour obtenir un code d'autorisation à l'aide de PCM.
4. Une fois la configuration terminée, copiez les valeurs de l'ID client OAuth 2.0 et du 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 d'activation de l'API.
2. Obtenez un ID client OAuth 2.0 sur la page des 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 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 projectutilisateurs.
   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. Si vous souhaitez des événements, sélectionnez Activer les événements, puis Créer un projet, puis modifiez le sujet Pub/Sub et fournissez un ID de sujet. 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 Device Access projet et n'est pas lié à un ID de projet Google Cloud.