Importar JSON en Google Sheets

Por qué Sheets no importa JSON y qué usar en su lugar

Google Sheets puede leer tres cosas directamente: CSV, TSV y una cuadrícula pegada. Puede traer un CSV remoto con IMPORTDATA, y la URL de una hoja de Google Sheets publicada es en sí un endpoint de CSV — pero no hay ningún camino integrado de un documento JSON a un rango de celdas. La respuesta oficial es Apps Script, y para algo puntual es más trabajo del que la tarea merece.

Así que el camino es CSV. Primero conviertes, luego importas, y todo el proceso toma alrededor de un minuto. La consecuencia importante es que cada limitación de CSV se convierte en una limitación de Sheets: una celda no distingue la cadena 22201 del número 22201, y no distingue una celda vacía de un campo que estaba ausente en el registro. Esas dos distinciones existen en tu JSON y no sobrevivirán al viaje, algo que conviene saber antes de borrar el original.

El cuadro de diálogo de importación, campo por campo

Archivo → Importar → Subir y elige el archivo. El cuadro de diálogo que aparece es donde se decide el resultado, y dos de sus controles marcan la diferencia.

El desplegable del separador viene con «Detectar» por defecto, que mira la primera línea y adivina. Esa suposición acierta lo suficiente como para fiarse de ella y falla lo suficiente como para merecer anularse: elige «Coma» o «Punto y coma» explícitamente, según lo que haya emitido el conversor. Si el archivo se abre con todo en la columna A, la suposición falló — vuelve a importar en lugar de intentar dividir la columna después.

La opción «Convertir texto en números, fechas y fórmulas» es la que hace el daño silencioso. Si la dejas activada, Sheets aplica sus propias heurísticas: un código de producto se vuelve un número y pierde sus ceros a la izquierda, una cadena de versión como 1.10 se vuelve una fecha, un ID largo se va a notación científica. Desactívala para importar cada valor como texto, exactamente como está escrito. Siempre puedes convertir una columna a propósito después; no puedes recuperar un cero a la izquierda que se eliminó en la importación.

Llevar el JSON anidado a columnas planas

El conversor aplana los objetos anidados en rutas con puntos y los arrays en rutas con corchetes, de modo que {"customer":{"name":"Ada"}} se convierte en una columna llamada customer.name y un array tags se convierte en tags[0], tags[1]. Las dos notaciones son deliberadamente distintas para que el nombre de una columna nunca sea ambiguo sobre cuál de ellas lo originó, y para que un viaje de ida y vuelta por CSV hacia JSON reconstruya el anidamiento.

El conjunto de columnas es la unión de los campos de todos los registros en orden de primera aparición. Esto importa más en Sheets que en una hoja de cálculo local, porque la importación es una operación de un solo disparo: un campo que solo aparece en el registro cuarenta aún recibe su propia columna, mientras que un conversor que lee el encabezado del primer registro lo pierde en silencio y te enteras semanas después, cuando un filtro no devuelve nada.

Los dos límites que sí puedes alcanzar

Una cuenta gratuita de Google permite 10,000,000 de celdas en una hoja de cálculo, y son 10,000,000 de valores, no de filas. Una exportación de 50 columnas se queda sin espacio en 200,000 filas, y una importación que supere el límite falla a mitad de camino con un mensaje sobre el archivo, no sobre el límite. Si tu exportación es más grande, divídela por rango de fechas o por prefijo de ID e importa las partes en hojas separadas.

El otro límite es el tamaño de archivo del cuadro de importación, que es 100 MB. Un CSV de cien mil registros con veinte columnas ronda los 20 MB, así que este es el menos probable de los dos — pero una exportación JSON con campos de texto largos puede alcanzarlo. El conversor se niega por encima de 8 MB de JSON en lugar de congelar la pestaña, así que en la práctica te encontrarás primero con ese límite, y te lo dirá.

Mantener la hoja al día con la fuente

Un rango importado es una instantánea. Si el JSON es una exportación de algo que cambia — una tabla de pedidos, un CRM, un volcado de analítica — la hoja queda desactualizada en el momento en que aterriza, y volver a importar a mano cada mañana es justo la tarea ingrata que termina en una hoja de cálculo rota en la que nadie confía.

Las opciones honestas son dos. Si la fuente puede publicar CSV por HTTP, IMPORTDATA lo trae de forma programada a una sola celda, y SPLIT más una fórmula de matriz lo despliega — sin paso de conversión alguno, a cambio de que los datos queden públicos para cualquiera con la URL. Si no, mantén la conversión local y repítela: la herramienta acepta un pegado, así que el ciclo es exportar, pegar, descargar, importar, y toma menos de un minuto. Lo que no vale la pena es conectar un Apps Script a una clave de API privada para que una hoja guarde una credencial que no debería guardar.