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:
- Inscrivez-vous au Device Access programme.
- Activez un appareil Nest compatible avec un compte Google.
- Créez un projet Google Cloud pour activer l'API SDM et obtenir un ID client OAuth 2.0.
- Créez un projet Device Access pour recevoir un ID de projet.
S'inscrire pour accéder à l'appareil
Avant de créer votre premier projet, vous devez vous inscrire à Device Access. L'inscription consiste à accepter les conditions d'utilisation de l'API Google et du bac à sable Device Access, ainsi qu'à payer des frais uniques et non remboursables (5 $) par compte.
Vous ne pourrez pas créer de projet tant que vous n'aurez pas accepté les conditions d'utilisation et payé les frais d'inscription. Cela s'applique à tous les utilisateurs, qu'ils soient des utilisateurs individuels ou des utilisateurs qui souhaitent créer une offre commerciale.
Si ce n'est pas déjà fait, enregistrez-vous dans la console Device Access :
Accéder à la Device Access console
Pour en savoir plus, consultez la section Enregistrement deDevice Access .
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
- Google Nest Hub Max
Consultez la page Appareils compatibles pour obtenir la liste des modèles d'appareils individuels.
Pour savoir comment activer votre 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 avez besoin d'un projet Google Cloud.
Utilisez 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:
- Si vous disposez 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. Cliquez ensuite sur le bouton, puis sélectionnez le projet existant dans la liste des projets disponibles. Sinon, créez un projet.
- Sélectionnez Web Server (Serveur Web) lorsque l'assistant vous demande "Where are you calling from?" (D'où appelez-vous ?).
- 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.
- Une fois la configuration terminée, copiez les valeurs de l'ID client et du secret client OAuth 2.0, puis téléchargez les identifiants JSON sur votre ordinateur local.
Si vous souhaitez configurer manuellement votre projet Google Cloud, ou vérifier la configuration et récupérer à nouveau vos identifiants:
- Activez l'API Smart Device Management sur la page Activation des API.
- Obtenez un ID client OAuth 2.0 sur la page Identifiants.
Créer un projet Device Access
Revenez à la Device Access console.
- Sur l'écran d'accueil de la console, sélectionnez Créer un projet.
- Remplissez chaque écran du processus de création :
- Saisissez le nom de votre projet.
- 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 pouvez le trouver dans le fichier
credentials.json
que vous avez téléchargé. - 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 structures autorisés pour votre projet. Sélectionnez Activer si vous souhaitez des événements. En cas de doute, sélectionnez Désactiver. Vous pourrez toujours les activer plus tard.
- Une fois le projet terminé, un ID de projet lui est attribué sous la forme d'un UUID, par exemple
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 associé à un ID de projet Google Cloud.