Todas las apps que acceden a las APIs de Google deben verificar que representen con exactitud su identidad y su intent según se especifica en la Política de Datos del Usuario de los Servicios de la API de Google. Para protegerte a ti y a los usuarios compartidos de Google y tu app, es posible que tu aplicación y pantalla de consentimiento necesiten una verificación de Google.
Tu app debe verificarse si cumple con todos los criterios que se indican a continuación:
- En Google API Console, la configuración de tu app se establece para un tipo de usuario Externo. Esto significa que tu app está disponible para cualquier usuario con una Cuenta de Google.
- Quieres que tu aplicación muestre un logotipo o nombre visible en la pantalla de consentimiento de OAuth.
Si incluyes información de marca verificada, puedes aumentar la probabilidad de que un usuario la reconozca y decida otorgar acceso a tu app. La información de marca verificada también puede generar menos revocaciones cuando un usuario o un administrador de Google Workspace revisen apps y servicios de terceros con acceso a la cuenta. El proceso de verificación de marca de la pantalla de consentimiento de OAuth suele tardar entre 2 y 3 días hábiles después de que se envía la verificación.
Si no envías tu solicitud para la verificación de marca, es posible que disminuya la confianza de los usuarios en tu solicitud de datos, lo que puede generar menos autorizaciones de usuarios y más revocaciones posteriores.
Pantalla de consentimiento de OAuth
La pantalla de consentimiento indica a los usuarios quién solicita acceso a sus datos y a qué tipo de datos necesita la app a la que debe acceder en su nombre, como se destaca en el cuadro 2 de la figura 1.
Cuando tu app se somete al proceso de verificación de marca y recibe la aprobación, es más probable que la cuenta que otorga el permiso entienda con claridad las políticas de identidad y de datos del usuario de la app. Esta comprensión clara puede aumentar la probabilidad de que el titular de la cuenta autorice tus solicitudes y conserve el acceso cuando revise las posibles revocaciones en la página de su Cuenta de Google. El contenido que configuras en OAuth Consent Screen page en API Console propaga los siguientes componentes:
- El nombre y el logotipo de tu app (como se muestran en el cuadro 1 de la figura 1)
- Tu correo electrónico de asistencia del usuario, que aparece después de seleccionar el nombre de la app (cuadro 2 de la figura 1)
- Vínculos a tu política de privacidad y a las condiciones del servicio (cuadro 3 de la figura 1)
![Las etiquetas numeradas muestran diferentes funciones de una pantalla de consentimiento de OAuth de un proyecto
con información de marca aprobada.](https://developers.google.cn/static/identity/protocols/oauth2/images/examples/oauth-consent-screen-components.png?authuser=8&hl=es)
Dominios autorizados
Como parte del proceso de verificación de marca, Google exige la verificación de todos los dominios asociados con las credenciales y la pantalla de consentimiento de OAuth de una aplicación. Te pedimos que verifiques el componente del dominio disponible para registrarlo en un sufijo público: el “dominio privado principal”. Por ejemplo, en una pantalla de consentimiento de OAuth que se configura con la página principal de la aplicación https://sub.example.com/product, se le solicita al titular de la cuenta que verifique la propiedad del dominio example.com.
La sección Dominios autorizados del editor de la pantalla de consentimiento de OAuth debe contener los dominios privados principales que se usan en los URI de la sección Dominio de la app. Estos dominios incluyen la página principal, la política de privacidad y las Condiciones del Servicio de la app. La sección Dominios autorizados también debe incluir los URI de redireccionamiento o los orígenes de JavaScript autorizados en los tipos de clientes de OAuth de "Aplicación web".
Verifica la propiedad de tus dominios autorizados con Google Search Console. Una Cuenta de Google con permisos de propietario para un dominio debe estar asociada con el proyecto API Console que usa ese dominio autorizado. Para obtener más información sobre las verificaciones de dominios en Google Search Console, consulta Cómo verificar la propiedad de tu sitio.
Pasos de preparación para la verificación
Todas las apps que usan las APIs de Google para solicitar acceso a los datos deben realizar los siguientes pasos para completar la verificación de marca:
- Confirma que tu app no entra en ninguno de los casos de uso de la sección Excepciones a los requisitos de verificación.
- Asegúrate de que tu app cumpla con los requisitos de desarrollo de la marca de las APIs o el producto asociados. Por ejemplo, consulta los lineamientos de desarrollo de la marca para los alcances de Acceso con Google.
- Verifica la propiedad de los dominios autorizados de tu proyecto en Google Search Console. Usa una Cuenta de Google asociada a tu proyecto de API Console como propietario o editor.
- Asegúrate de que toda la información de marca en la pantalla de consentimiento de OAuth, como el nombre de la app, el correo electrónico de asistencia, el URI de la página principal, el URI de la política de privacidad, etc., represente con precisión la identidad de la app.
Requisitos de la página principal de la aplicación
Asegúrate de que la página principal cumpla con los siguientes requisitos:
- Tu página principal debe ser de acceso público, y no solo los usuarios registrados en tu sitio deben poder acceder a ella.
- La relevancia de tu página principal para la app que está en proceso de revisión debe ser clara.
- Los vínculos a la ficha de tu app en Google Play Store o su página de Facebook no se consideran páginas principales válidas de la aplicación.
Requisitos del vínculo a la Política de Privacidad de la aplicación
Asegúrate de que la política de privacidad de tu app cumpla con los siguientes requisitos:
- La política de privacidad debe ser visible para los usuarios, alojada en el mismo dominio que la página principal de tu aplicación y vinculada a la pantalla de consentimiento de OAuth de Google API Console. Ten en cuenta que la página principal debe incluir una descripción de la funcionalidad de la app, así como vínculos a la política de privacidad y a las condiciones del servicio opcionales.
- En la política de privacidad, se debe divulgar la forma en que la aplicación accede a los datos del usuario de Google, los usa, los almacena o los comparte. Debes limitar el uso que le des a los datos del usuario de Google a las prácticas que divulga tu política de privacidad publicada.
Cómo enviar una app para verificarla
Un proyecto deGoogle API Console organiza todos tus API Console recursos. Un proyecto consiste en un conjunto de Cuentas de Google asociadas que tienen permiso para realizar operaciones del proyecto, un conjunto de API habilitadas y configuración de facturación, autenticación y supervisión para esas API. Por ejemplo, un proyecto puede contener uno o más clientes de OAuth, configurar las APIs para que las usen esos clientes y configurar una pantalla de consentimiento de OAuth que se muestre a los usuarios antes de que autoricen el acceso a tu app.
Si alguno de tus clientes de OAuth no está listo para la producción, te sugerimos que lo borres del proyecto que solicita la verificación. Puedes hacerlo en Google API Console.
Para solicitar la verificación, sigue estos pasos:
- Asegúrate de que tu app cumpla con las Condiciones del Servicio de las APIs de Google y la Política de Datos del Usuario de los Servicios de las APIs de Google.
- Mantén actualizados los roles de propietario y editor de las cuentas asociadas de tu proyecto, así como la información de contacto del desarrollador y el correo electrónico de asistencia del usuario de tu pantalla de consentimiento de OAuth en tu API Console. Esto garantiza que se notifique a los miembros correctos de tu equipo sobre cualquier requisito nuevo.
- Ve a API Console OAuth Consent Screen page.
- Haz clic en el botón Selector de proyectos.
-
En el cuadro de diálogo Seleccionar una opción que aparece, elige tu proyecto. Si no encuentras el proyecto, pero conoces el ID del proyecto, puedes crear una URL en el navegador con el siguiente formato:
https://console.developers.google.com/apis/credentials/consent?project=[PROJECT_ID]
Reemplaza [PROJECT_ID] por el ID del proyecto que deseas usar.
- Selecciona el botón Edit App.
- Ingresa la información necesaria en la página de la pantalla de consentimiento de OAuth y, luego, selecciona el botón Guardar y continuar.
- Usa el botón Agregar o quitar permisos para declarar todos los permisos que solicita tu app. Un conjunto inicial de permisos necesarios para el Acceso con Google se completa previamente en la sección Alcances no sensibles. Los permisos agregados se clasifican como no sensibles, sensitive, or restricted.
- Proporciona hasta tres vínculos a cualquier documentación relevante para funciones relacionadas en tu app.
-
Proporciona cualquier información adicional que se solicite sobre la app en los pasos posteriores.
- Si la configuración de la app que proporcionas requiere verificación, tienes la oportunidad de enviar la app para verificarla. Completa los campos obligatorios y, luego, haz clic en Enviar para iniciar el proceso de verificación.
Después de que envíes la app, el equipo de Confianza y Seguridad de Google se comunicará por correo electrónico con la información adicional necesaria o los pasos que debes completar. Verifica tus direcciones de correo electrónico en la sección Información de contacto del desarrollador y el correo electrónico de asistencia de tu pantalla de consentimiento de OAuth para solicitar información adicional. También puedes ver la página de la pantalla de consentimiento de OAuth de tu proyecto para confirmar el estado de revisión actual de tu proyecto, lo que incluye si el proceso de revisión se detiene mientras esperamos tu respuesta.
Excepciones a los requisitos de verificación
Si tu app se usará en alguna de las situaciones descritas en las siguientes secciones, no es necesario que la envíes para su revisión.
Uso personal
Un caso práctico es si eres el único usuario de tu app o si solo unos pocos usuarios la usan, de los cuales todos conoces personalmente. Es posible que tú y una cantidad limitada de usuarios se sientan cómodos con el paso de la pantalla de la app no verificada y la concesión de acceso a la app a tus cuentas personales.
Proyectos que se usan en los niveles de Desarrollo, Pruebas o etapa de pruebas
A fin de cumplir con las políticas de Google OAuth 2.0, te recomendamos que tengas diferentes proyectos para entornos de prueba y producción. Te recomendamos que solo envíes tu app para verificación si quieres que esté disponible para cualquier usuario con una Cuenta de Google. Por lo tanto, si tu app está en las fases de desarrollo, prueba o etapa de pruebas, no se requiere verificación.
Si tu app está en las fases de desarrollo o prueba, puedes dejar el Estado de publicación en la configuración predeterminada de Prueba. Con esta configuración, la app aún está en desarrollo y solo está disponible para los usuarios que agregues a la lista de usuarios de prueba. Debes administrar la lista de Cuentas de Google que participan en el desarrollo o las pruebas de tu app.
![Mensaje de advertencia que indica que Google no verificó una app que se está probando.](https://developers.google.cn/static/identity/protocols/oauth2/images/examples/tester-warning-screen.png?authuser=8&hl=es)
Solo datos que son propiedad del servicio
Si tu app usa una cuenta de servicio para acceder solo a sus propios datos y no accede a los datos del usuario (vinculados a una Cuenta de Google), no es necesario que envíes la verificación.
Para comprender qué son las cuentas de servicio, consulta Cuentas de servicio en la documentación de Google Cloud. Si quieres obtener instrucciones para usar una cuenta de servicio, consulta Usa OAuth 2.0 para aplicaciones de servidor a servidor.
Solo para uso interno
Esto significa que solo las personas de tu organización de Google Workspace o Cloud Identity usan la app. El proyecto debe ser propiedad de la organización, y su pantalla de consentimiento de OAuth debe configurarse para un tipo de usuario Interno. En este caso, es posible que tu app necesite la aprobación de un administrador de la organización. Para obtener más información, consulta Consideraciones adicionales para Google Workspace.
- Obtén más información sobre las aplicaciones internas y públicas.
- Obtén información para marcar tu app como interna en las Preguntas frecuentes ¿Cómo puedo marcar mi app como solo para uso interno?
Instalación en todo el dominio
Si planeas que tu app se oriente únicamente a los usuarios de una organización de Google Workspace o Cloud Identity y siempre usas la instalación para todo el dominio, tu app no requerirá la verificación de la app. Esto se debe a que una instalación en todo el dominio permite que un administrador otorgue a las aplicaciones internas y de terceros acceso a los datos de los usuarios. Los administradores de la organización son las únicas cuentas que pueden agregar la app a una lista de entidades permitidas para usarla en sus dominios.
Obtén información para convertir tu app en una instalación para todo el dominio en la sección de Preguntas frecuentes Mi aplicación tiene usuarios con cuentas empresariales de otro dominio de Google Workspace.