Les API Home utilisent OAuth 2.0 pour accorder l'accès aux appareils de la structure. OAuth permet à un utilisateur d'accorder une autorisation à une application ou à un service sans avoir à exposer ses identifiants de connexion.
Si vous disposez déjà d'un client OAuth validé (par exemple, à partir d'une application déjà publiée), vous pouvez l'utiliser pour tester les API Home sans en configurer un nouveau. Pour en savoir plus, consultez Si vous disposez d'un client OAuth existant.
Signer l'application
Commencez par générer un certificat de débogage en exécutant votre application dans Android Studio. Lorsque vous exécutez ou déboguez une application dans Android Studio, un certificat de débogage destiné au développement et au débogage est généré automatiquement. Pour obtenir une explication complète, consultez Android Studio : Sign your debug build (Android Studio : Signer votre version de débogage).
Une fois l'application exécutée :
Connectez votre appareil mobile à votre machine locale. Android Studio affiche la liste de vos appareils connectés par numéro de modèle. Sélectionnez votre appareil dans la liste, puis cliquez sur Exécuter le projet. L'application exemple est alors compilée et installée sur votre appareil mobile.
Pour obtenir des instructions plus détaillées, consultez Exécuter des applications sur un appareil sur le site Android Developers.
Arrêtez l'application en cours d'exécution.
Obtenez l'empreinte SHA-1 du certificat de débogage en suivant les instructions détaillées dans Configurer OAuth 2.0 / Applications natives/ Android sur le site d'aide de la console Google Cloud.
Configurer l'écran de consentement OAuth
- Dans la console Google Cloud, accédez au tableau de bord du sélecteur de projet et sélectionnez le projet que vous souhaitez utiliser pour créer des identifiants OAuth.
- Accédez à la page API et services, puis cliquez sur Identifiants dans le menu de navigation.
Si vous n'avez pas encore configuré votre écran de consentement pour ce projet Google Cloud, le bouton Configurer l'écran de consentement s'affiche. Dans ce cas, configurez votre écran de consentement en suivant la procédure ci-dessous. Sinon, passez à la section suivante.
- Cliquez sur Configurer l'écran de consentement. La page Écran de consentement OAuth s'affiche.
- Selon votre cas d'utilisation, sélectionnez Interne ou Externe, puis cliquez sur Créer. Le volet Écran de consentement OAuth s'affiche.
- Saisissez les informations sur la page d'informations sur l'application en suivant les instructions à l'écran, puis cliquez sur Enregistrer et continuer. Le volet Champs d'application s'affiche.
- Vous n'avez pas besoin d'ajouter de champs d'application. Cliquez donc sur Enregistrer et continuer. Le volet Utilisateurs test s'affiche.
- Cliquez sur Audience , puis sur le bouton + AJOUTER DES UTILISATEURS.
- Saisissez l'adresse e-mail de votre utilisateur test, puis cliquez sur le bouton ENREGISTRER.
- Cliquez sur Enregistrer et continuer. Le volet Récapitulatif s'affiche.
- Vérifiez les informations de votre écran de consentement OAuth, puis cliquez sur Retour au tableau de bord.
Pour en savoir plus, consultez Configurer votre écran de consentement OAuth sur le site d'aide de la console Google Cloud.
Enregistrer l'application et créer des identifiants
Pour enregistrer l'application pour OAuth 2.0 et créer des identifiants OAuth, suivez les instructions fournies dans Configurer OAuth 2.0. Vous devrez indiquer le type d'application, qui est application native/Android.
Ajoutez l'empreinte SHA-1 que vous avez obtenue en signant l'application au client OAuth que vous avez configuré dans la console Google Cloud en suivant les instructions de la section Configurer OAuth 2.0 / Applications natives sur le site d'aide de la console Google Cloud.
Une fois votre appareil mobile connecté à votre machine locale, sélectionnez-le dans la liste, puis cliquez à nouveau sur Exécuter le projet pour l'exécuter. Pour obtenir des instructions plus détaillées, consultez Exécuter des applications sur un appareil sur le site Android Developers.
Si vous disposez d'un client OAuth existant
Si vous disposez déjà d'un client OAuth validé pour une application publiée, vous pouvez l'utiliser pour tester les API Home.
Google Home Developer Console l'enregistrement n'est pas obligatoire pour tester et utiliser les API Home. Toutefois, vous aurez toujours besoin d'un enregistrement approuvé Developer Console pour publier votre application, même si vous disposez d'un client OAuth validé à partir d'une autre intégration.
Les considérations suivantes s'appliquent :
Lorsque vous utilisez un client OAuth existant, vous êtes limité à 100 utilisateurs. Pour savoir comment ajouter des utilisateurs test, consultez Configurez l'écran de consentement OAuth. Indépendamment de la validation OAuth, les API Home imposent une limite de 100 utilisateurs pouvant accorder des autorisations à votre application. Cette limite est supprimée une fois l' enregistrement Developer Consoleterminé.
Developer Console enregistrement doit être envoyé pour approbation lorsque vous êtes prêt à limiter les autorisations de type d'appareil via OAuth en vue de mettre à jour votre application avec les API Home.
Pour les applications Google Cloud dont la validation OAuth est toujours en attente, les utilisateurs ne peuvent pas effectuer le flux OAuth tant que la validation n'est pas terminée. Les tentatives d'octroi d'autorisations échoueront avec l'erreur suivante :
Access blocked: <Project Name> has not completed the Google verification process.