Una agencia que gestiona Google Business Profile para 20 clientes distintos enfrenta un problema que un solo negocio no tiene: cada cliente debe autorizar el acceso por separado vía OAuth, y la agencia necesita un sistema que administre múltiples tokens sin mezclarlos.
El modelo correcto: un proyecto, múltiples cuentas autorizadas
La agencia mantiene un solo proyecto en Google Cloud Console con sus credenciales OAuth, pero cada cliente completa su propio flujo de consentimiento, generando un refresh token independiente que la agencia almacena de forma segura y aislada por cliente.
Cómo estructurar el almacenamiento de tokens
Cada refresh token debe asociarse a un identificador único de cliente, cifrarse en reposo, y renovarse automáticamente antes de que el access token expire, sin intervención manual del equipo de la agencia.
Qué pasa cuando un cliente revoca el acceso
El sistema debe detectar el error de autorización en la siguiente llamada a la API, marcar esa cuenta como desconectada, y alertar al equipo en lugar de fallar silenciosamente o reintentar indefinidamente.
Preguntas frecuentes
¿Necesito un proyecto de Google Cloud distinto por cliente?
No. Un solo proyecto puede recibir autorizaciones OAuth de múltiples cuentas de Google Business Profile distintas; lo que varía por cliente es el token generado, no el proyecto.
¿Las cuotas de API se comparten entre todos los clientes de la agencia?
Sí, si todos operan bajo el mismo proyecto de Cloud Console. Es importante dimensionar la cuota total considerando el volumen combinado de todos los clientes gestionados.
Mejores prácticas para la gestión de OAuth
1. **Documentación clara**: Mantén una documentación detallada sobre el proceso de autorización y el manejo de tokens para cada cliente.
2. **Auditoría regular**: Realiza auditorías periódicas para verificar que todos los tokens están activos y que no hay accesos no autorizados.
3. **Automatización**: Implementa scripts que automaticen la renovación de tokens y la gestión de errores.
4. **Capacitación del equipo**: Asegúrate de que todos los miembros del equipo estén capacitados en el manejo de la API y en la gestión de OAuth.
5. **Monitoreo de uso**: Utiliza herramientas de monitoreo para rastrear el uso de la API y detectar cualquier anomalía.
Casos de uso de la Google Business Profile API en agencias
1. **Gestión de múltiples ubicaciones**: Las agencias pueden gestionar perfiles de Google Business para empresas con varias sucursales, asegurando que cada ubicación tenga la información correcta y actualizada.
2. **Optimización de la visibilidad local**: A través de la API, las agencias pueden optimizar la información de los clientes para mejorar su visibilidad en búsquedas locales.
3. **Análisis de rendimiento**: Las agencias pueden utilizar la API para extraer datos sobre el rendimiento de los perfiles de negocio, lo que les permite hacer recomendaciones informadas a sus clientes.
Conclusión
Para agencias, la Google Business Profile API permite operar decenas de cuentas de clientes desde un solo sistema, siempre que el manejo de tokens y cuotas se diseñe correctamente desde el inicio. Siguiendo las mejores prácticas y entendiendo los casos de uso, las agencias pueden maximizar el valor de esta herramienta.