Incrusta reseñas de Google en tu web de forma fiable y segura siguiendo un flujo claro y evitando los errores comunes con tokens y OAuth2.
Resumen del problema original y requisitos básicos: para leer reseñas necesitas un proyecto en Google Cloud con la API Google Business Profile activada, un cliente OAuth2 que te dé client_id y client_secret, y las credenciales resultantes: refresh token y access token. Además necesitas obtener accountId y locationId de la cuenta de empresa. Con eso puedes consultar el endpoint de reseñas y mostrar nombre del reseñador, puntuación en estrellas y comentario en tu HTML.
Paso 1 verifica credenciales y permisos: asegúrate de que el cliente OAuth2 tenga el scope necesario para gestionar el perfil de empresa: https://www.googleapis.com/auth/business.manage. Puedes comprobar si el access token está válido con tokeninfo ejecutando curl -G https://oauth2.googleapis.com/tokeninfo --data-urlencode access_token=ACCESS_TOKEN. Si la respuesta incluye error o expiración el token no es válido.
Paso 2 cómo obtener accountId y locationId: realiza una llamada autenticada para listar cuentas y luego las ubicaciones. Ejemplos de curl sin comillas: curl -H Authorization:Bearer ACCESS_TOKEN https://businessprofile.googleapis.com/v1/accounts para listar cuentas y curl -H Authorization:Bearer ACCESS_TOKEN https://businessprofile.googleapis.com/v1/accounts/ACCOUNT_ID/locations para listar ubicaciones. En la respuesta JSON busca fields name o name con formato accounts/ACCOUNT_ID y locations/LOCATION_ID que te darán los identificadores correctos.
Paso 3 cómo obtener y renovar tokens: el flujo recomendado es generar un refresh token una sola vez en el proceso de autorización interactiva y almacenar ese refresh token seguro en tu servidor. Para renovar el access token usa curl -d client_id=CLIENT_ID -d client_secret=CLIENT_SECRET -d refresh_token=REFRESH_TOKEN -d grant_type=refresh_token https://oauth2.googleapis.com/token. La respuesta contiene un nuevo access_token y expires_in. Verifica y actualiza tu almacenamiento seguro.
Paso 4 comprobación práctica de permisos y errores: si al pedir reseñas obtienes 401 o 403 revisa que el access token sea válido y que el usuario autorizado tenga acceso a esa cuenta y ubicación. Si recibes 404 revisa que accountId y locationId sean correctos y que la cuenta tenga reseñas públicas.
Paso 5 consulta de reseñas y ejemplo de llamada: para obtener reseñas usa el endpoint reviews de Business Profile API. Ejemplo de curl: curl -H Authorization:Bearer ACCESS_TOKEN https://businessprofile.googleapis.com/v1/accounts/ACCOUNT_ID/locations/LOCATION_ID/reviews. Procesa el JSON devuelto y extrae reviewer.displayName, starRating y comment o commentText según la versión de la API.
Paso 6 ejemplo de integración en PHP, ideas y buenas prácticas: almacena refresh token en base de datos o en archivo cifrado. Implementa una función que intente usar el access token y si recibe 401 haga la petición de refresh token y reintente la consulta. También puedes usar la librería oficial googleapis para PHP que automatiza refreshs si configuras correctamente client_id client_secret redirect_uri y token. Principio general pseudocódigo: span>$accessToken obtiene de almacenamiento seguro span>si petición a reviews responde 401 entonces solicitar nuevo access token con refresh token y actualizar almacenamiento span>usar access token vigente para solicitar reseñas y generar HTML
Paso 7 ejemplo de plantilla HTML simple para mostrar reseñas que puedes rellenar tras parsear JSON en servidor: Nombre del reseñador 5 Comentario de la reseña aquí
Sugerencias operativas y seguridad: guarda client_secret y refresh_token fuera del repositorio de código, con permisos restringidos. Usa HTTPS en tu servidor y controla el acceso a endpoints de administración. Considera cachear las reseñas durante un intervalo razonable para no exceder cuotas y reducir latencia.
Flujo recomendado completo en 6 pasos: registrar proyecto y habilitar API, crear credenciales OAuth2, realizar autorización interactiva para obtener refresh token, listar accounts y locations para obtener IDs reales, usar refresh token para obtener access token y llamar a reviews, servir HTML sanitizado con los campos de reseña.
Comprobación de validez de tokens de forma automatizada: realizar periódicamente tokeninfo o una petición de prueba a accounts o locations. Si expires_in está próximo a 0 o recibes 401 ejecutar refresh token y reemplazar access token en almacenamiento.
Ventajas de integrar reseñas con soluciones a medida: al trabajar con una plataforma propia puedes transformar y presentar reseñas según tu diseño, filtrar por puntuación, destacar reseñas con foto o crear widgets responsivos. En Q2BSTUDIO somos especialistas en crear soluciones a medida que integran APIs externas y adecuados procesos de seguridad, desde desarrollo de aplicaciones hasta despliegue en cloud y análisis de datos. Si buscas una aplicación personalizada podemos ayudarte en el desarrollo de la integración de reseñas y en la puesta en marcha. Consulta nuestro servicio de desarrollo de aplicaciones y software a medida en desarrollo de aplicaciones y software multiplataforma y si necesitas alojamiento seguro y escalable revisa nuestros servicios cloud en servicios cloud AWS y Azure.
Palabras clave para SEO incluidas de forma natural: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi. Si necesitas soporte para automatizar el refresco de tokens, desarrollar un endpoint seguro que sirva las reseñas o crear paneles con Power BI para analizar opiniones de clientes, en Q2BSTUDIO podemos ayudarte a diseñar la solución completa.
Si quieres puedo proporcionarte un ejemplo concreto de script PHP o de un pequeño microservicio que use curl para refrescar tokens y obtener reseñas, adaptado a tu entorno de hosting y guardado seguro de credenciales. Indica si prefieres ejemplo usando la librería oficial de Google para PHP o un script ligero con curl y lo preparo para ti.
