Tus datos en Google Sheets, Power BI y Looker Studio
Tres plantillas para conectar tu hoja o tu informe a la API con tu propia clave, sin programar nada: las pegas, pones la clave y se rellenan con tus cuentas, tus movimientos y tus indicadores mensuales. Son gratis, van con cualquier plan (todos leen por la API) y solo leen: no pueden cambiar nada ni gastan cupo de lecturas, porque leer por la API no llama al banco.
1. Antes de empezar: una clave de «Solo leer»
-
Saca la clave en el panel, en Ajustes → API y webhooks, y elige «Solo leer». Una
hoja o un informe no necesitan más, y con ella cualquier petición que no sea de lectura responde
403sin tocar nada. -
¿Quieres probar antes? Con una clave de prueba (
ebd_test_…) las plantillas funcionan igual, sobre datos de ejemplo. Cada fila lo dice (is_demo,sample_data) y las plantillas lo marcan. Más en el sandbox. -
Las plantillas buscan solas la empresa si la clave alcanza una sola. Si alcanza varias (una
asesoría), te dejan elegir, o puedes copiar su
iddeGET https://app.easybankdata.com/v1/tenants. -
La dirección de la API ya va puesta en los ficheros:
https://app.easybankdata.com/v1.
2. Google Sheets
Un Apps Script que añade el menú EasyBankData a tu hoja y crea cuatro pestañas: EBD Cuentas, EBD Movimientos, EBD Indicadores (los últimos 12 meses completos con el mismo mes del año anterior) y EBD Categorías (por categoría y mes, lista para una tabla dinámica).
Descargar el script de Google Sheets
- En tu hoja, Extensiones → Apps Script. Borra lo que haya en
Código.gsy pega el fichero entero. Guarda. - Recarga la hoja. Aparece el menú EasyBankData.
- EasyBankData → Poner la clave de la API. Google te pedirá permiso para que el script salga a internet y escriba en la hoja.
- EasyBankData → Actualizar todo.
- Si quieres que se actualice sola: Activar la actualización diaria (hacia las 6:00).
- La clave no va en ninguna celda. Se guarda en las propiedades de usuario del script: solo la ves tú, con tu cuenta de Google. Si compartes la hoja, quien la abra ve los datos pero no la clave.
-
Los movimientos se traen una vez y después solo los cambios
(
updated_sinceconsort=updated), que se mezclan por su identificador: una reclasificación de un movimiento antiguo también llega. - Las cuatro pestañas se reescriben en cada actualización. Tus fórmulas y gráficos, en otras pestañas que lean de ellas.
- Google corta una ejecución a los 6 minutos. Con decenas de miles de movimientos, la primera carga puede no caber; las siguientes son cortas.
3. Power BI y Excel (Power Query)
Diez consultas en M para pegar: tres parámetros (EBD_Clave,
EBD_Empresa, EBD_Base), dos funciones
(EBD_Leer y EBD_Todas, que recorre las páginas con
el testigo de la API) y las tablas Empresas, Cuentas, Movimientos,
IndicadoresMensuales y Categorias. Valen igual en Power BI Desktop y en Excel.
Descargar las consultas de Power Query
- Power BI: Transformar datos → Nueva fuente → Consulta en blanco. Excel: Datos → Obtener datos → De otras fuentes → Consulta en blanco.
- Editor avanzado: pega el bloque de una consulta y ponle exactamente el nombre que dice su separador. Repite con las diez, en orden.
- Pon tu clave en
EBD_Clave. Carga Empresas, copia elidy ponlo enEBD_Empresa. - Cuando pregunte cómo conectar con la dirección de la API, elige Anónimo: la clave ya va en la cabecera de la consulta.
- Cerrar y aplicar. Cada actualización vuelve a leer todo.
- La clave queda dentro del fichero (.pbix o .xlsx), en el parámetro. Quien tenga el fichero tiene la clave: no lo compartas con ella puesta. Si se te escapa, revócala en el panel y saca otra.
-
Si al actualizar sale «las credenciales no son válidas», es la clave (mal copiada o revocada),
no la conexión anónima: cámbiala en
EBD_Clave. Power Query se queda él con esa respuesta y no deja enseñar el mensaje de la API; los demás errores sí salen con su código. -
Los importes se convierten a número decimal fijo (
Currency.Type), no a coma flotante, y los indicadores, de céntimos a euros. -
Para traer menos movimientos, pon una fecha en
Desdeal principio de la consulta Movimientos.
4. Looker Studio
Un conector de comunidad (Apps Script) con autenticación por clave. Da dos fuentes de datos a elegir: Movimientos (uno por fila, en el intervalo de fechas del informe, con importe, entrada, salida, categoría, cuenta y etiquetas) e Indicadores mensuales (entradas, salidas y neto por mes, con el año anterior; como mucho los 24 últimos meses del intervalo).
Descargar el conector Descargar su appsscript.json
- En script.google.com, Nuevo proyecto. Pega el conector en
Código.gs. - Configuración del proyecto → marca «Mostrar el archivo de manifiesto». Sustituye
appsscript.jsonpor el que has descargado. - Implementar → Probar implementaciones y copia el ID de implementación principal.
- Abre
https://lookerstudio.google.com/datasources/create?connectorId=<ese ID>, autoriza y pega tu clave de «Solo leer». - Elige la empresa y qué datos, y Conectar.
- La clave se guarda en las propiedades de usuario del script, no en el informe. Pero quien vea un informe compartido ve los datos que se leen con ella: así funcionan las fuentes de Looker Studio. Piensa qué enseñas antes de compartirlo.
- Para quitar la clave: en la fuente de datos, Editar conexión → Revocar acceso.
5. Qué llama cada plantilla
Solo lecturas GET del contrato público, con
Authorization: Bearer <clave>. La lista sale de los propios ficheros.
| Plantilla | Rutas |
|---|---|
easybankdata-sheets.gs |
/tenants/tenants/{tenant}/accounts/tenants/{tenant}/insights/categories/tenants/{tenant}/insights/monthly/tenants/{tenant}/transactions |
easybankdata-power-query.pq |
/tenants/tenants/{tenant}/accounts/tenants/{tenant}/insights/categories/tenants/{tenant}/insights/monthly/tenants/{tenant}/transactions |
easybankdata-looker-studio.gs |
/tenants/tenants/{tenant}/accounts/tenants/{tenant}/insights/monthly/tenants/{tenant}/transactions |
6. Lo que conviene saber
- La categoría es la tuya, la del panel (a mano, con tus reglas o con las de serie). La que trae el banco va aparte, como «categoría del banco».
- Los indicadores no cuentan los traspasos entre tus cuentas ni suman las cuentas en otra divisa, igual que en el panel.
- El nombre de la contraparte se enmascara pasado el plazo de conservación: a partir de ahí sale como «(enmascarada)».
- Toda lectura queda registrada en el registro de accesos de la empresa, con la clave que la hizo. Si una hoja deja de usarse, revoca su clave.
- La API admite 120 peticiones por minuto y clave, de 500 movimientos cada una. Las plantillas de Google esperan y reintentan si se pasa; Power Query avisa y basta con volver a actualizar.
Siguiente: empezar · la API entera · qué puede fallar