Configurer OAuth pour votre application Android

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éjà d'un client OAuth.

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 automatiquement généré. Pour en savoir plus, consultez Android Studio : Signer votre build de débogage.

Une fois l'application lancée :

1. Connectez votre appareil mobile à votre ordinateur local. Android Studio listera vos appareils connectés par numéro de modèle. Sélectionnez votre appareil dans la liste, puis cliquez sur Run project (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 des développeurs Android.

2. Arrêtez l'application en cours d'exécution.

3. 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

1. 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.
2. Accédez à la page API et services, puis cliquez sur Identifiants dans le menu de navigation.

3. Si vous n'avez pas encore configuré l'é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.

   1. Cliquez sur Configurer l'écran d'autorisation. La page Écran de consentement OAuth s'affiche.
   2. Selon votre cas d'utilisation, sélectionnez Interne ou Externe, puis cliquez sur Créer. Le volet Écran de consentement OAuth s'affiche.
   3. Saisissez les informations sur la page Informations sur l'application en suivant les instructions à l'écran, puis cliquez sur Enregistrer et continuer. Le volet Champs d'application s'affiche.
   4. Vous n'avez pas besoin d'ajouter de champs d'application. Cliquez donc sur Enregistrer et continuer. Le volet Utilisateurs de test s'affiche.
   5. Cliquez sur Audience, puis sur le bouton + AJOUTER DES UTILISATEURS.
   6. Saisissez l'adresse e-mail de votre utilisateur test, puis cliquez sur le bouton ENREGISTRER.
   7. Cliquez sur Enregistrer et continuer. Le volet Résumé s'affiche.
   8. Vérifiez les informations de l'écran de consentement OAuth, puis cliquez sur Revenir au tableau de bord.

Pour en savoir plus, consultez la page 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 de la section Configurer OAuth 2.0. Vous devrez indiquer le type d'application, à savoir Application native/application 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 ordinateur local, sélectionnez-le dans la liste, puis cliquez à nouveau sur Run project (Exécuter le projet) pour l'exécuter. Pour obtenir des instructions plus détaillées, consultez Exécuter des applications sur un appareil matériel sur le site des développeurs Android.

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.

L'enregistrement Google Home Developer Console n'est pas requis pour tester et utiliser les API Home. Toutefois, vous devrez toujours disposer d'une inscription Developer Console approuvée pour publier votre application, même si vous disposez d'un client OAuth validé provenant d'une autre intégration.

Les considérations suivantes s'appliquent :

• La limite est de 100 utilisateurs lorsque vous utilisez un client OAuth existant. Pour savoir comment ajouter des utilisateurs de test, consultezConfigurez 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 levée une fois l'inscription Developer Console terminée.

• L'enregistrementDeveloper Console doit être envoyé pour approbation lorsque vous êtes prêt à limiter les autorisations de types d'appareils 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 terminer 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.