Un Google Apps Script que carga datos de la API de un servicio en su hoja de cálculo de Google y los mantiene al día

Ejemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Carpeta: sales/2026-10, 9 archivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 filas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 filas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 filas sin precio omitidas (líneas 88, 412, 913)
2026-11-02 09:14:05 INFO  Listo: 10.412 filas -> report-2026-10.xlsx (hojas “Ventas” y “Totales”)

[columns]
date = Fecha, Fecha de venta, Día
product = Producto, Artículo, Nombre
quantity = Cant., Cantidad, Uds.
price = Precio, Precio unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lee el archivo de una tienda y le da los nombres de columna del informe."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: no hay columna para '{name}' (se buscó {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Acerca de este servicio

Pedidos de la plataforma de su tienda, tareas de un servicio de proyectos, entradas de un sistema de reservas: si el servicio tiene una API pública, los datos pueden llegar a su hoja de cálculo de Google sin exportar archivos a mano. Este Google Apps Script envía una solicitud a la API con su propia clave, toma los campos que necesita y los escribe como filas, página tras página. Desde Estándar la clave va en las propiedades del script, que rellena usted, no en el código, y los errores van a una pestaña de Registro; Premium añade solo las filas nuevas o cambiadas y una guía para ejecutarlo cada hora o cada día con un activador. Envíenos un enlace a la documentación de la API y los campos que quiere. Una sola ejecución está limitada a unos seis minutos, así que las importaciones muy grandes se hacen por partes.

Qué incluye

• Qué recibeUn archivo ZIP con el código de Apps Script y un README que explica cómo añadirlo a su hoja, poner su clave y ejecutarlo; el código también se muestra en la página del pedido.
• Según la documentaciónEscrito a partir de la propia documentación de la API
• Los campos que elijaSolo las columnas que necesita, en su orden
• Todas las páginasLos resultados paginados se leen hasta el final
• La clave, fuera del códigoUsted la pone en las propiedades del script
• Código legibleCon comentarios, fácil añadir un campo más adelante

Cómo funciona

1. 1
   TareaUsted envía la documentación de la API y los campos que necesita
2. 2
   CódigoEscribimos el script según la documentación y la guía para instalarlo
3. 3
   PruébeloAñade su clave en una copia de la hoja y lo ejecuta
4. 4
   CambiosPide cambios dentro de su paquete y nos envía cualquier mensaje de error

Qué necesitamos de usted

El servicio y un enlace a la documentación de su API, la solicitud que necesita (por ejemplo, los pedidos de los últimos 30 días) y los campos que deben convertirse en columnas. Un ejemplo de la respuesta de la API ayuda mucho: cópielo de la documentación o de una llamada de prueba sin valores privados. Con qué frecuencia deben actualizarse los datos y si se añaden filas nuevas o se reescribe la hoja. No envíe nunca su clave de API real: el README indica dónde ponerla.

Le preguntaremos:

• ¿Qué servicio y dónde está la documentación de su API?
• ¿Qué datos necesita?
• ¿Con qué frecuencia debe actualizarse?

Comparar paquetes

Preguntas y respuestas

¿No encontró su respuesta? Pregúntenos