¿Se puede importar JSON con IMPORTDATA?
IMPORTDATA admite datos CSV y TSV, no convierte una respuesta JSON en columnas. Si tu proveedor ofrece una exportación CSV pública y accesible, puedes valorar esa opción. Si solo entrega JSON, necesitas transformar sus campos con Apps Script, un conector o una conversión previa. La referencia de IMPORTDATA de Google indica los formatos admitidos.
Cómo importar JSON a Google Sheets sin complementos
Abre Extensiones > Apps Script, adapta uno de los ejemplos de esta guía a la URL y a la estructura real de tu respuesta y ejecútalo desde el editor. Revisa los permisos solicitados antes de autorizarlos. UrlFetchApp permite realizar la petición HTTP; después hay que seleccionar los registros y convertirlos en filas. No necesitas instalar un complemento para este método.
Si el origen devuelve un objeto con una lista dentro de items, utiliza esa lista; si devuelve una lista en la raíz, recórrela directamente. Antes de sustituir datos existentes, prueba la importación en una hoja vacía. Una URL de ejemplo no contiene tus datos ni representa una API lista para usar.

Para importar datos JSON a Google Sheets puedes usar Apps Script: obtener la respuesta de la API, analizarla y escribir una tabla de filas y columnas. En esta guía encontrarás ejemplos de código, alternativas con conectores y comprobaciones para errores, objetos anidados y paginación.
Comprender los conceptos básicos
¿Qué es JSON?
JSON (JavaScript Object Notation) es un formato ligero de intercambio de datos que es fácil de leer y escribir para los humanos, y fácil de analizar y generar para las máquinas. El formato JSON se utiliza ampliamente en el desarrollo web para transmitir datos entre un servidor y una aplicación web.
¿Qué es Hojas de cálculo de Google?
Google Sheets es una aplicación de hoja de cálculo basada en web proporcionada por Google. Permite a los usuarios crear, editar y compartir hojas de cálculo en línea. Google Sheets es parte de la suite Google Docs Editors, que incluye Google Docs, Google Slides y Google Forms.
¿Por qué importar JSON a Google Sheets?
Importar datos JSON a Google Sheets es esencial para diversas aplicaciones, particularmente en análisis y visualización de datos. Google Sheets proporciona potentes herramientas para manipular y visualizar datos, lo que facilita la comprensión y el trabajo con datos JSON.
Pasos para importar datos JSON a Google Sheets
Usando la secuencia de comandos de aplicaciones de Google
Google Apps Script es una poderosa herramienta para automatizar tareas en Google Sheets. Así es como puedes usarlo para importar datos JSON a una hoja de Google:
- Abrir Hojas de cálculo de Google: Vaya a Google Sheets y abra la hoja de cálculo donde desea importar los datos JSON.
- Crear un nuevo guión: Haga clic en Extensiones > Apps Script para abrir el editor de secuencias de comandos.
- Escribe el guión: Pegue el siguiente código para obtener datos JSON de una URL específica e insértelos en su hoja de Google.
function importarJSON() {
const url = 'https://api.example.com/data'; // Sustituye esta URL.
const respuesta = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
const estado = respuesta.getResponseCode();
if (estado < 200 || estado >= 300) {
throw new Error('La API respondió con HTTP ' + estado);
}
const datos = JSON.parse(respuesta.getContentText());
if (!Array.isArray(datos)) {
throw new Error('Se esperaba una lista de objetos JSON.');
}
if (datos.length === 0) return;
if (datos.some(fila => fila === null || typeof fila !== 'object' || Array.isArray(fila))) {
throw new Error('Cada registro debe ser un objeto JSON.');
}
const encabezados = [...new Set(datos.flatMap(fila => Object.keys(fila)))];
if (encabezados.length === 0) return;
const filas = datos.map(fila => encabezados.map(clave => {
const valor = fila[clave];
return valor == null ? '' : typeof valor === 'object' ? JSON.stringify(valor) : valor;
}));
const tabla = [encabezados, ...filas];
const hoja = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
hoja.getRange(hoja.getLastRow() + 1, 1, tabla.length, encabezados.length).setValues(tabla);
}
Sustituye la URL por una API que devuelva una lista de objetos. Este ejemplo añade los datos al final de la pestaña activa; pruébalo primero en una hoja vacía.
- Ejecute el script: Guarde y ejecute el script. Este script obtendrá datos JSON de la URL especificada, los analizará y los insertará en la hoja de Google activa.
Uso de complementos de Google Sheets
Los complementos pueden ofrecer una interfaz para conectar una API con Google Sheets. Busca las opciones disponibles en Extensiones > Complementos > Obtener complementos y comprueba los permisos y la documentación del proveedor antes de instalar uno.
El nombre de la función y sus argumentos dependen del complemento: utiliza el ejemplo que indique su documentación. Si prefieres una función propia, el siguiente apartado incluye el código completo de IMPORTJSON.
Usar funciones personalizadas
También puede crear una función personalizada en Google Sheets para importar datos JSON. He aquí un ejemplo:
- Crear una función personalizada: Abra el editor de secuencias de comandos y pegue el siguiente código:
/**
* Importa una lista JSON pública como tabla.
* @param {string} url URL de la API.
* @return {Array<Array<*>>} Encabezados y registros.
* @customfunction
*/
function IMPORTJSON(url) {
const respuesta = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
const estado = respuesta.getResponseCode();
if (estado < 200 || estado >= 300) {
throw new Error('La API respondió con HTTP ' + estado);
}
const datos = JSON.parse(respuesta.getContentText());
if (!Array.isArray(datos)) {
throw new Error('Se esperaba una lista de objetos JSON.');
}
if (datos.length === 0) return [['Sin datos']];
if (datos.some(fila => fila === null || typeof fila !== 'object' || Array.isArray(fila))) {
throw new Error('Cada registro debe ser un objeto JSON.');
}
const encabezados = [...new Set(datos.flatMap(fila => Object.keys(fila)))];
if (encabezados.length === 0) return [['Sin campos']];
const filas = datos.map(fila => encabezados.map(clave => {
const valor = fila[clave];
return valor == null ? '' : typeof valor === 'object' ? JSON.stringify(valor) : valor;
}));
return [encabezados, ...filas];
}
- Utilice la función personalizada: En su hoja de cálculo de Google, utilice la función personalizada para buscar e insertar datos JSON. Por ejemplo:
=IMPORTJSON("https://api.example.com/data")
Guarda primero el script anterior y sustituye la URL por una API pública real que devuelva una lista de objetos. Escribe la fórmula en una celda con espacio libre debajo y a la derecha para expandir la tabla. IMPORTJSON es la función que acabas de crear, no una función integrada de Google Sheets. Consulta las instrucciones oficiales sobre funciones personalizadas.
Manejo del formato JSON y errores
Al importar datos JSON a Google Sheets, es importante asegurarse de que el formato JSON sea coherente y esté bien estructurado. A continuación se ofrecen algunos consejos para manejar el formato JSON y los errores:
- Validar datos JSON: utilice bibliotecas o herramientas en línea para validar sus datos JSON antes de importarlos a Google Sheets.
- Manejar objetos JSON anidados: Si sus datos JSON contienen objetos anidados, es posible que deba escribir código adicional para aplanar los datos antes de insertarlos en Google Sheets.
- Administrar grandes conjuntos de datos: Para conjuntos de datos JSON grandes, considere usar paginación o procesamiento por lotes para evitar alcanzar los límites de Google Sheets.
Ejemplo de datos JSON
A continuación se muestra un ejemplo de datos JSON que puede importar a Google Sheets:
[
{
"Name": "John Doe",
"Age": 30,
"Email": "john.doe@example.com"
},
{
"Name": "Jane Smith",
"Age": 25,
"Email": "jane.smith@example.com"
}
]
Conclusión
Importar JSON a Google Sheets es una forma poderosa de aprovechar las capacidades de Google Sheets para el análisis y la visualización de datos. Ya sea que utilice Google Apps Script, complementos o funciones personalizadas, comprender el proceso y manejar problemas comunes lo ayudará a administrar y utilizar de manera efectiva sus datos JSON.
Preguntas frecuentes
¿Puedes importar JSON a Google Sheets?
Sí, puede importar JSON a Google Sheets utilizando varios métodos, incluidos Google Apps Script, complementos y funciones personalizadas.
¿Cómo abro un archivo JSON en Google?
Para abrir un archivo JSON en Google Sheets, puede usar Google Apps Script o un complemento como Importar JSON para buscar e insertar los datos JSON en su hoja de Google.
¿Cómo importar un archivo JSON a una hoja de cálculo?
Puede importar un archivo JSON a una hoja de cálculo utilizando una secuencia de comandos para buscar y analizar los datos JSON y luego insertarlos en la hoja de cálculo. Alternativamente, puede utilizar complementos que proporcionen funciones integradas para importar datos JSON.
¿Cómo se analiza JSON en una hoja de cálculo?
Puede analizar JSON en una hoja de cálculo utilizando un script o una función personalizada para recuperar los datos JSON, analizarlos e insertarlos en la hoja de cálculo. El script debe manejar el formato JSON y garantizar que los datos se inserten correctamente en las celdas y columnas adecuadas.
Qué método elegir para importar JSON
El método depende del formato disponible y de cómo se actualizan los datos. Si el servicio ofrece una exportación CSV o TSV, IMPORTDATA puede leer ese archivo; la función documentada por Google no convierte directamente una respuesta JSON. Si solo tienes un endpoint JSON público, Apps Script puede solicitarlo con UrlFetchApp, analizar la respuesta con JSON.parse y escribir valores en una hoja. Para un flujo que requiere autenticación, paginación o ejecuciones repetidas, conviene valorar un script vinculado con un menú o una integración mantenida, en lugar de una función personalizada en cada celda.
Antes de elegir, confirma que tienes permiso para consultar la API, que el endpoint admite peticiones desde Google y que sus condiciones permiten el uso previsto. Comprueba también el tamaño de la respuesta, el número de registros y si hay paginación. Un JSON pequeño con una lista plana se transforma con facilidad; un objeto con listas anidadas requiere decidir qué campos irán a cada columna.
Ejemplo de Apps Script para leer una respuesta JSON
Este ejemplo supone que la API devuelve una lista de objetos con las propiedades id, name y email. Sustituye la URL y los campos por los de tu servicio. El ejemplo borra solo el contenido de la pestaña «Datos» que utiliza; prueba primero en una hoja nueva y elimina clearContents() si necesitas conservar valores anteriores.
function importarJson() {
const url = 'https://api.example.com/users';
const response = UrlFetchApp.fetch(url, { muteHttpExceptions: true });
const status = response.getResponseCode();
if (status < 200 || status >= 300) {
throw new Error('La API respondio con HTTP ' + status);
}
const payload = JSON.parse(response.getContentText());
const records = Array.isArray(payload) ? payload : payload.items;
if (!Array.isArray(records)) {
throw new Error('La respuesta no contiene una lista en la raiz ni en items');
}
const rows = records.map(item => [item.id || '', item.name || '', item.email || '']);
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const sheet = spreadsheet.getSheetByName('Datos') || spreadsheet.insertSheet('Datos');
sheet.clearContents();
sheet.getRange(1, 1, 1, 3).setValues([['ID', 'Nombre', 'Correo']]);
if (rows.length) sheet.getRange(2, 1, rows.length, 3).setValues(rows);
}
muteHttpExceptions permite leer el código de respuesta y mostrar un error más claro para HTTP 401, 403, 429 o errores del servidor. No convierte esos estados en éxito: hay que resolver la autenticación, los permisos, los límites de peticiones o la disponibilidad del servicio. Si la API devuelve los registros dentro de otra propiedad —por ejemplo, results— cambia payload.items por el nombre real y prueba con una respuesta de ejemplo.
Cómo convertir objetos anidados en columnas
Las hojas trabajan mejor con filas rectangulares. Si cada registro tiene un objeto address, elige de antemano si necesitas address.city, address.country o el objeto completo como texto. Si una propiedad contiene otra lista, decide si generarás una fila por elemento o si la resumirás en una celda. Esa decisión evita que registros con distinto número de campos desplacen los datos entre columnas.
Para una respuesta con forma {"items":[...]}, inspecciona primero una muestra del JSON y escribe una fila de encabezados que coincida con los campos seleccionados. En una estructura variable, algunos objetos pueden no traer una propiedad; en ese caso devuelve una cadena vacía o un valor claramente identificado como ausente. No conviertas automáticamente números, fechas y textos sin comprobar el formato de origen.
Errores, paginación y límites
Si solo aparece la primera parte de los resultados, revisa la documentación de la API para saber si entrega un cursor, un token de continuación o un número máximo de registros por respuesta. La paginación debe implementarse de acuerdo con ese contrato; no basta con repetir la misma URL. Comprueba el código HTTP, el tipo de contenido y que el cuerpo sea JSON válido antes de sobrescribir la hoja. Para ejecuciones repetidas, conserva una fecha de actualización y registra los errores sin guardar datos personales innecesarios.
Apps Script tiene cuotas de servicio que pueden cambiar. La documentación de Google publica los límites actuales de URL Fetch y del tiempo de ejecución; evita una llamada a la API por cada celda y agrupa los datos en una sola solicitud cuando el servicio lo permita. Las funciones personalizadas tienen restricciones y tiempo máximo de ejecución, por lo que un menú o una ejecución manual puede ser más adecuado para operaciones que modifican una tabla completa.
Protege las credenciales y revisa el acceso
No escribas tokens, claves privadas ni contraseñas dentro de una celda, una URL compartida o el código visible para cualquiera que pueda editar el proyecto. Usa el mecanismo de almacenamiento de credenciales que permita tu entorno y limita el acceso a la hoja y al script. Recuerda que las personas con permiso de edición del proyecto pueden tener acceso a su código y configuración; comparte solo con quienes deban mantener la integración y rota las claves si se exponen.
Si el objetivo es integrar datos en una aplicación o panel propio, no fuerces todo el proceso dentro de una hoja. Puedes revisar los servicios de diseño web para empresas o consultar a dKambio sobre una integración. Para conocer quién mantiene este sitio y su criterio editorial, visita Sobre dKambio.
Si el JSON procede de una exportación de consultas o herramientas de palabras clave, puedes ordenar sus campos y después aplicar el método de investigación de palabras clave orientada al negocio para decidir qué datos merecen seguimiento. Encontrarás más guías en Blog de dKambio.
JSON anidado: comprueba las columnas antes de escribir en Sheets
Una respuesta válida puede contener objetos que no encajan directamente en una celda. Antes de usar setValues, define qué representa una fila. En este ejemplo cada registro es un contacto y la ciudad procede de un objeto anidado. El valor cero se conserva y los campos ausentes quedan vacíos.
function filasContactos(datos) {
if (!Array.isArray(datos)) throw new Error('Se esperaba una lista');
const textoCelda = valor => {
const texto = valor == null ? '' : String(valor);
return /^\s*[=+@-]/.test(texto) ? "'" + texto : texto;
};
return datos.map(item => {
if (!item || typeof item !== 'object' || Array.isArray(item)) {
throw new Error('Registro no valido');
}
const ciudad = item.direccion ? item.direccion.ciudad : '';
const saldo = typeof item.saldo === 'number' ? item.saldo : textoCelda(item.saldo);
return [textoCelda(item.nombre), textoCelda(ciudad), saldo];
});
}
Prueba la transformación con una lista pequeña y comprueba que cada fila tiene tres columnas. Un nombre que comienza por el signo igual se trata aquí como texto mediante un apóstrofo inicial, para evitar convertir datos externos en fórmulas. El ejemplo limita su contrato a campos de texto y un saldo numérico; valida otros tipos si tu API los utiliza.
Escribe el resultado en una pestaña dedicada a la importación, conservando aparte tus fórmulas y notas. Si la nueva respuesta tiene menos filas que la anterior, decide cómo retirar los registros sobrantes: escribir un rango más pequeño no borra automáticamente lo que había debajo. Verifica primero la respuesta completa y no limpies toda una hoja que contenga trabajo manual.
La referencia de Range.setValues explica el formato de matriz requerido. Este bloque solo transforma los datos: no realiza llamadas HTTP ni se ejecuta como una fórmula de celda. Puedes usarlo después de analizar una respuesta y antes de la escritura final.
