Conecta Google Sheets a tu agente de IA

Métodos de autenticación

• OAuth 2.0

Abre la consola local, selecciona un proveedor y configura sus credenciales. Los proveedores OAuth requieren una aplicación OAuth que registres en ese servicio.

Qué comprobar en este conector

Este ejemplo busca hojas de cálculo accesibles para la conexión de Google. Comprueba los ámbitos de lectura declarados y el acceso a archivos de la cuenta seleccionada. Una lista vacía no demuestra un fallo del entorno de ejecución.

Inspecciona la acción antes de invocarla

Objetivo del ejemplo

Busca hojas de cálculo accesibles para la cuenta de Google conectada.

Ámbitos requeridos por la acción

• https://www.googleapis.com/auth/spreadsheets.readonly
• https://www.googleapis.com/auth/drive.readonly

Lee el esquema de tu instancia en ejecución. Comprueba los datos de entrada requeridos, los permisos y la conexión de la cuenta antes de ejecutar.

curl -s http://localhost:3000/v1/actions/googlesheets.search_spreadsheets

Tras conectar una cuenta, adapta los datos de entrada del ejemplo a tus recursos. Añade un token Bearer del entorno de ejecución si su autenticación está habilitada.

curl -s -X POST \
  http://localhost:3000/v1/actions/googlesheets.search_spreadsheets \
  -H 'content-type: application/json' \
  -d '{"input":{"maxResults":5}}'

Lee el resultado

Las respuestas HTTP del entorno usan success, message, data y meta. Inspecciona success y el esquema de salida de la acción, no solo el estado HTTP. Cuando los metadatos de ejecución incluyan executionId, úsalo para localizar el registro correspondiente con datos sensibles ocultos. El ejemplo siguiente ilustra la estructura de la respuesta; no es un resultado de la API en vivo.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Si falla la llamada

• Si falla la autenticación, comprueba el endpoint y el tipo de credencial: el acceso de administración protege /api; un token Bearer del entorno autoriza /v1 y /mcp. Una clave de API del proveedor no es un token del entorno de ejecución.
• Si se deniega un permiso, comprueba los ámbitos requeridos por la acción, las reglas de acciones del entorno y las concesiones de conexión. Un token válido puede seguir sin tener permiso para usar la cuenta seleccionada.
• Si faltan resultados o están vacíos, confirma la cuenta conectada y su acceso al recurso solicitado. Una autorización exitosa no concede acceso a todos los espacios de trabajo, canales o documentos.
• Inspecciona el error y el registro de ejecución antes de reintentar. Si una acción modifica datos del proveedor, comprueba si ya terminó; no repitas la solicitud a ciegas.

Próximos pasos

Para los proveedores compatibles, OOMOL gestiona la configuración de la aplicación OAuth y el entorno de ejecución alojado. Tú sigues eligiendo la cuenta y aprobando sus permisos.