En la siguiente tabla, se resumen las credenciales que debe administrar una app. Para obtener más información sobre los tipos de apps, consulta la documentación de OAuth 2.0 de Google Identity.
| Flujo de trabajo de autenticación | Credencial | Tipo de credencial | Objetivo |
|---|---|---|---|
|
Apps web de JavaScript Apps para Android |
ID de cliente de OAuth | Credenciales de la app | Identifica de forma única la app durante un flujo de OAuth. |
| Token de acceso y token de actualización | Credenciales de usuario | Representa la autorización del usuario para permitir que la app acceda a su cuenta de Google Ads en su nombre. | |
|
Apps web del servidor Apps para computadoras y iOS Apps para TV y dispositivos |
ID de cliente y secreto del cliente de OAuth | Credenciales de la app | Identifica de forma única la app durante un flujo de OAuth. |
| Token de acceso y token de actualización | Credenciales de usuario | Representa la autorización del usuario para permitir que la app acceda a su cuenta de Google Ads en su nombre. | |
| Cuentas de servicio | Clave de cuenta de servicio de OAuth | Credenciales de la app | Se usa para firmar la solicitud de OAuth. |
| Token de acceso de la cuenta de servicio | Credenciales de usuario | Representa la autorización de la cuenta de servicio cuando un usuario comparte su cuenta de Google Ads con la cuenta de servicio. |
Hay varios puntos que debes tener en cuenta cuando administras las credenciales de una app de la API de Google Ads.
Controla las credenciales de la app de forma segura
Las credenciales de la app hacen referencia a la configuración específica de tu app y no varían de un usuario a otro. Trata las credenciales de tu app de OAuth con extremo cuidado, ya que permiten que cualquier persona que las tenga use la identidad de tu app para acceder a la información del usuario. Almacena las credenciales de tu app de OAuth en un lugar seguro y protégelas, como lo harías con una contraseña. Cuando sea posible, usa un administrador de Secrets, como Secret Manager de Google Cloud, para almacenar las credenciales de la app. Nunca debes confirmar las credenciales de cliente en repositorios de código disponibles de forma pública. Te recomendamos que evites confirmarlas en cualquier repositorio de código.
Controla las credenciales de los usuarios de forma segura
Las credenciales de usuario se refieren a los tokens de OAuth que representan la autorización del usuario. Los usuarios te las confían cuando te otorgan permiso para actuar y acceder a los datos en su nombre, ya sea directamente autenticando tu app o indirectamente compartiendo su cuenta de Google Ads con tu cuenta de servicio. Nunca transmitas tokens en texto sin formato y almacena siempre los tokens encriptados en reposo para proporcionar una capa adicional de protección en caso de una violación de la seguridad de los datos. Revoca los tokens o los permisos de la cuenta de servicio cuando ya no necesites acceder a la cuenta de un usuario. Después de revocar los tokens, bórralos de forma permanente de tu aplicación o sistema.
Controla la revocación y el vencimiento de los tokens de actualización
Si usas un flujo de autenticación de usuarios, ten en cuenta que los tokens de actualización se pueden invalidar en cualquier momento. Por ejemplo, si usas un flujo de autenticación multiusuario, el usuario podría optar por revocar el acceso a tu app. Si bien es menos probable que una app que usa un flujo de autenticación de un solo usuario se vea afectada de esta manera, un proceso manual o automatizado diseñado para proteger a los usuarios podría borrar el token de actualización, o bien este podría vencer. Si tu app requiere una notificación de revocación de tokens para brindar una buena experiencia a los usuarios, debes integrarla con el servicio de Protección integral de la cuenta.
Reutiliza las credenciales de usuario en tus solicitudes a la API
Los tokens de acceso de OAuth son de corta duración y vencen después de una hora. Si usas una biblioteca cliente de la API de Google Ads, esta controla el vencimiento y la actualización de los tokens de acceso de forma segura para los subprocesos. Crea un objeto de cliente de API de Google Ads con las credenciales de OAuth adecuadas y vuelve a usarlo durante todo su ciclo de vida.
Si creas tu propia estrategia de actualización y administración de tokens de acceso, haz un seguimiento del
vencimiento de los tokens de acceso y reutilízalos mientras sigan siendo válidos. Cuando
solicitas una actualización de token, el servidor de autorización devuelve un token de acceso nuevo
junto con el tiempo de vida restante en segundos
(expires_in). Te recomendamos que actualices el token de acceso de forma proactiva si
quedan menos de 5 minutos antes de que venza.