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 Google Identity OAuth 2.0.
| 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 la app de forma inequívoca 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 iOS y computadoras Apps para TV y dispositivos |
ID de cliente y secreto del cliente de OAuth | Credenciales de la app | Identifica la app de forma inequívoca 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. |
Existen varios puntos que debes tener en cuenta cuando administras las credenciales de una app de la API de Google Ads.
Maneja 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 mucho 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, al igual que una contraseña. Cuando sea posible, usa un administrador de secretos, como Google Cloud Secret Manager, para almacenar las credenciales de la app. Nunca debes confirmar las credenciales del cliente en repositorios de código disponibles públicamente. Te recomendamos que evites confirmarlas en cualquier repositorio de código.
Maneja las credenciales de usuario de forma segura
Las credenciales de usuario hacen referencia a los tokens de OAuth que representan la autorización del usuario. Los usuarios te los confían cuando te dan 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 siempre almacena 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.
Maneja la revocación y el vencimiento del token 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 aún podría borrar definitivamente el token de actualización, o 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, la biblioteca controla el vencimiento y la actualización del token de acceso de forma segura para subprocesos. Crea un objeto cliente de API de Google Ads con las credenciales de OAuth adecuadas y reutilízalo durante su ciclo de vida.
Si creas tu propia estrategia de actualización y administración de tokens de acceso, haz un seguimiento del vencimiento del token de acceso y reutiliza los tokens mientras sigan siendo válidos. Cuando solicitas una actualización de tokens, el servidor de autorización muestra un token de acceso nuevo
junto con el tiempo de vida restante en segundos
(expires_in). Te recomendamos que actualices de forma proactiva el token de acceso si quedan menos de 5 minutos antes del vencimiento.