Cómo importar JSON a Google Sheets

Un ejemplo que puedes repetir

Importaremos diez usuarios desde JSONPlaceholder, una API pública de prueba que no necesita clave:

La respuesta contiene campos simples como id, name y email, además de objetos anidados como address y company. Conservaremos cinco columnas: id, name, email, address.city y company.name.

Paso 1

Abre JSON for Sheets

Abre la hoja donde quieres insertar la tabla. En el menú, elige Extensions → JSON for Sheets → Open JSON for Sheets. La barra lateral se abrirá a la derecha.

Paso 2

Elige Public URL e introduce la dirección JSON

Selecciona Public URL y pega el endpoint. Deja Root path vacío porque la respuesta de este ejemplo ya es un array de usuarios en el nivel superior. Mantén Simple path y Keep as JSON seleccionados.

Si necesitas autenticación, parámetros, cuerpos de solicitud o paginación, consulta la guía completa de conexión a una API JSON en inglés.

Paso 3

Revisa el JSON antes de modificar la hoja

Selecciona Preview JSON. El complemento solicita la respuesta actual, convierte las propiedades en rutas de columnas y muestra cuántas filas y campos detectó. La vista previa no escribe nada en la hoja.

Para este endpoint aparecen 10 filas y 15 campos. Así puedes detectar una ruta equivocada o una respuesta inesperada antes de reemplazar celdas.

Paso 4

Selecciona solamente las columnas necesarias

Elige Select none y marca id, name, email, address.city y company.name. La tabla de muestra se actualiza de inmediato al cambiar la selección.

Importar menos campos reduce el tamaño de la tabla y evita llenar la hoja con metadatos que no vas a usar.

Paso 5

Elige el destino y escribe la tabla

Usa Selected cell para comenzar en la celda activa o New sheet para crear una pestaña separada. En una primera importación, selecciona Overwrite, confirma que el destino puede reemplazarse y elige Write table.

La ejecución de ejemplo insertó 10 registros. Después de escribir una fuente remota correctamente, puedes guardar la configuración para ejecutarla de nuevo sin reconstruir la solicitud.

Cómo subir un archivo .json a Google Sheets

1. Abre JSON for Sheets y selecciona From file.
2. Elige un archivo .json local de hasta 5 MB.
3. Configura la ruta raíz y el tratamiento de arrays si es necesario.
4. Genera la vista previa, selecciona campos y escribe la tabla.

El archivo se lee dentro de la sesión del complemento, no se envía a los servidores de JSON for Sheets y no consume solicitudes remotas.

Cómo trata el complemento el JSON anidado

Los objetos se convierten en rutas con puntos. Por ejemplo, el siguiente objeto produce una columna address.city:

{
  "name": "Leanne Graham",
  "address": {
    "city": "Gwenborough"
  }
}

Para arrays anidados puedes conservar el JSON completo en una celda, unir valores con un delimitador o expandir cada elemento a una fila. Elige según lo que debe representar una fila de tu tabla.

Cómo mantener los datos actualizados

Las respuestas remotas se solicitan de nuevo; JSON for Sheets no entrega una copia guardada en caché. Puedes volver a generar la vista previa o guardar una importación después de escribirla.

• Free: cinco páginas remotas correctas por día UTC y ejecuciones manuales de importaciones guardadas.
• Starter: un límite mensual y programaciones diarias o semanales.
• Pro: un límite mensual mayor y programaciones cada hora, diarias o semanales.

Las programaciones son opcionales. Google Picker te pide seleccionar la hoja actual antes de permitir que el complemento vuelva a abrir ese archivo específico cuando está cerrado.

Problemas comunes al importar JSON

Preguntas frecuentes