Las APIs de Home usan OAuth 2.0 para otorgar acceso a los dispositivos de la estructura. OAuth permite que un usuario otorgue permiso a una app o un servicio sin tener que exponer sus credenciales de acceso.
Si ya tienes un cliente de OAuth verificado (por ejemplo, de una app ya publicada), puedes usarlo para probar las APIs de Home sin configurar uno nuevo. Para obtener más información, consulta Si tienes un cliente de OAuth existente.
Firma la app
Primero, genera un certificado de depuración ejecutando tu app en Android Studio. Cuando ejecutas o depuras una app en Android Studio, se genera automáticamente un certificado de depuración destinado al desarrollo y la depuración. Consulta Android Studio: Firma tu compilación de depuración para obtener una explicación completa.
Una vez que se ejecute la app, haz lo siguiente:
Conecta tu dispositivo móvil a tu máquina local. Android Studio mostrará tus dispositivos conectados por número de modelo. Selecciona tu dispositivo de la lista y, luego, haz clic en Ejecutar proyecto. Esto compila e instala la app de ejemplo en tu dispositivo móvil.
Para obtener instrucciones más detalladas, consulta Cómo ejecutar apps en un dispositivo de hardware en el sitio para desarrolladores de Android.
Detén la app en ejecución.
Para obtener la huella digital SHA-1 del certificado de depuración, sigue las instrucciones que se detallan en Configura OAuth 2.0 / Aplicaciones nativas / Android en el sitio de ayuda de la consola de Google Cloud.
Configura la pantalla de consentimiento de OAuth
- En la consola de Google Cloud, ve al panel de selección de proyectos y selecciona el proyecto que deseas usar para crear credenciales de OAuth.
- Ve a la página APIs y servicios y haz clic en Credenciales en el menú de navegación.
Si aún no configuraste la pantalla de consentimiento para este proyecto de Google Cloud, aparecerá el botón Configurar pantalla de consentimiento. En ese caso, configura la pantalla de consentimiento con el siguiente procedimiento. De lo contrario, pasa a la siguiente sección.
- Haz clic en Configurar pantalla de consentimiento. Se muestra la página Pantalla de consentimiento de OAuth.
- Según tu caso de uso, selecciona Interno o Externo y, luego, haz clic en Crear. Se muestra el panel Pantalla de consentimiento de OAuth.
- Ingresa la información en la página Información de la app según las instrucciones en pantalla y, luego, haz clic en Guardar y continuar. Se muestra el panel Permisos.
- No es necesario que agregues ningún permiso, así que haz clic en Guardar y continuar. Se muestra el panel Usuarios de prueba.
- Haz clic en Público y, luego, en el botón + AGREGAR USUARIOS.
- Ingresa la dirección de correo electrónico del usuario de prueba y haz clic en el botón GUARDAR.
- Haz clic en Guardar y continuar. Se muestra el panel Resumen.
- Revisa la información de la pantalla de consentimiento de OAuth y, luego, haz clic en Volver al panel.
Registra la app y crea credenciales
Para registrar la app para OAuth 2.0 y crear credenciales de OAuth, sigue las instrucciones que se proporcionan en Configura OAuth 2.0. Deberás indicar el tipo de app, que es app nativa/para Android.
Agrega la huella digital SHA-1 que obtuviste de la firma de la app al cliente de OAuth que configuraste en la consola de Google Cloud siguiendo las instrucciones que se indican en Configura OAuth 2.0 / Aplicaciones nativas en el sitio de ayuda de Google Cloud Console.
Con tu dispositivo móvil conectado a tu máquina local, selecciona tu dispositivo de la lista y, luego, haz clic en Ejecutar proyecto nuevamente para ejecutarlo. Para obtener instrucciones más detalladas, consulta Cómo ejecutar apps en un dispositivo de hardware en el sitio para desarrolladores de Android.
Si tienes un cliente de OAuth existente
Si ya tienes un cliente de OAuth verificado para una app publicada, puedes usar tu cliente de OAuth existente para probar las APIs de Home.
No es necesario registrarse en Google Home Developer Console para probar y usar las APIs de Home. Sin embargo, aún necesitarás un registro aprobado Developer Console para publicar tu app, incluso si tienes un cliente de OAuth verificado de otra integración.
Se aplican las siguientes consideraciones:
Hay un límite de 100 usuarios cuando se usa un cliente de OAuth existente. Para obtener información sobre cómo agregar usuarios de prueba, consulta Configura la pantalla de consentimiento de OAuth. Independientemente de la verificación de OAuth, hay un límite impuesto por las APIs de Home de 100 usuarios que pueden otorgar permisos a tu aplicación. Esta limitación se levanta cuando se completa el registro Developer Console.
Developer Console El registro se debe enviar para su aprobación cuando estés listo para restringir las concesiones de tipo de dispositivo a través de OAuth en preparación para actualizar tu app con las APIs de Home.
En el caso de las apps de Google Cloud que aún no se verificaron con OAuth, los usuarios no pueden completar el flujo de OAuth hasta que se complete la verificación. Los intentos de otorgar permisos fallarán con el siguiente error:
Access blocked: <Project Name> has not completed the Google verification process.