Configurar tu propio acceso a Google

Para que rankion.ai pueda leer tus datos de Google Search Console, Google Analytics 4 y tu Perfil de Empresa de Google, tu equipo necesita su propio acceso a Google: un cliente OAuth en tu proyecto de Google Cloud. Lo creas una vez e introduces dos valores en rankion.ai, el ID de cliente y el secreto del cliente. A partir de entonces, cada conexión de tu equipo pasa por tu propio proyecto de Google.

Solo los propietarios y administradores de tu equipo pueden configurar el acceso. Los demás miembros ven si hay uno guardado.

Antes de empezar

Abre en rankion.ai la página Integración de Google (/integrations/google). Arriba está la sección Acceso a Google de tu equipo con dos URI de redireccionamiento autorizados:

Toma siempre las direcciones de esa página, con el botón Copiar. Google las compara carácter por carácter; una barra que falte o sobre al final provoca «Error 400: redirect_uri_mismatch».

Paso 1: crear un proyecto de Google Cloud

1. Abre Google Cloud Console e inicia sesión con la cuenta de Google a la que pertenecen tu Search Console y tu Analytics.
2. En el selector de proyectos de arriba elige Proyecto nuevo, ponle un nombre (por ejemplo «rankion») y créalo.
3. Comprueba que el proyecto nuevo esté seleccionado arriba antes de continuar.

Paso 2: habilitar las API

En API y servicios → Biblioteca busca cada una de las siguientes API y haz clic en Habilitar:

• Google Search Console API
• Google Analytics Data API
• Google Analytics Admin API

Solo si quieres obtener reseñas de tu Perfil de Empresa, además:

• My Business Account Management API
• My Business Business Information API
• Google My Business API

Google solo desbloquea las API del Perfil de Empresa tras una solicitud de acceso. La envías mediante el formulario que Google enlaza en la documentación de las Business Profile APIs.

Paso 3: configurar la pantalla de consentimiento

1. Abre API y servicios → Pantalla de consentimiento de OAuth (en consolas más nuevas el área se llama Google Auth Platform).
2. Elige Externo como público. Si tu cuenta de Google pertenece a una organización de Google Workspace y solo personas de ella usan rankion.ai, basta con Interno.
3. Introduce un nombre de app, tu correo de soporte y una dirección de contacto.
4. En Acceso a los datos (o Permisos) añade estos permisos: .../auth/webmasters.readonly, .../auth/analytics.readonly y, solo para reseñas, .../auth/business.manage.
5. Pon el estado de publicación de la app en En producción. En el estado Prueba solo pueden iniciar sesión los usuarios de prueba registrados, y Google deja caducar la autorización a los siete días. La conexión en rankion.ai deja entonces de funcionar.

Para los permisos de lectura Google puede exigir una verificación de una app externa. Mientras no termine, Google muestra al conectar el aviso «Esta app no está verificada»; mediante Configuración avanzada puedes continuar igualmente con tu propia cuenta.

Paso 4: crear el cliente OAuth

1. Abre API y servicios → Credenciales (o Google Auth Platform → Clientes).
2. Elige Crear credenciales → ID de cliente de OAuth.
3. Tipo de aplicación: Aplicación web. El nombre es libre.
4. En URI de redireccionamiento autorizados introduce ambas direcciones de rankion.ai, cada una en su propia línea.
5. Guarda. Google te muestra ahora el ID de cliente (termina en .apps.googleusercontent.com) y el secreto del cliente (suele empezar por GOCSPX-).

Paso 5: introducir los valores en rankion.ai

1. De vuelta en Integración de Google en rankion.ai: introduce el ID de cliente y el secreto del cliente en la sección Acceso a Google de tu equipo.
2. Haz clic en Guardar acceso. El estado cambia a Acceso propio activo.
3. Ahora haz clic en Conectar con Google. A partir de aquí el inicio de sesión pasa por tu proyecto de Google.

El secreto del cliente se guarda cifrado y no se vuelve a mostrar, ni siquiera en parte. Para conservar el ID de cliente y renovar el secreto, introduce el secreto nuevo. Si dejas el campo vacío, se conserva el secreto guardado.

Qué pasa con las conexiones existentes

• Las conexiones que tu equipo creó antes del acceso propio siguen funcionando sin cambios.
• Si introduces un ID de cliente nuevo o eliminas el acceso, las conexiones que pasaban por el acceso anterior deben volver a conectarse. Google vincula cada autorización exactamente al cliente con el que se concedió. Esas conexiones aparecen después como «caducadas»; un clic en Otra cuenta con la misma cuenta de Google las restablece.

Errores frecuentes

Relacionado: Primeros pasos · API: API de integraciones de Google (GET /v1/google/oauth-client muestra el estado, sin el secreto).