Un Google Apps Script que copia registros entre su base de Airtable y una hoja de cálculo de Google, en un sentido o en ambos

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

En un proyecto, unas personas trabajan en Airtable y otras solo en Hojas de cálculo de Google, y copiar registros entre ambos acaba saliendo mal tarde o temprano. Este Google Apps Script lee su base de Airtable mediante su API oficial con su propio token de acceso personal y escribe los registros que elija en una hoja: una tabla o una vista, con los campos que necesita como columnas. Desde Estándar guarda el ID del registro en cada fila, así que una segunda ejecución actualiza las filas en lugar de duplicarlas, y muestra los registros vinculados como nombres. Premium envía los cambios de la hoja de vuelta a Airtable según la regla que fije sobre qué lado prevalece. Su token va en las propiedades del script, que rellena usted, nunca en el código. Funciona al ritmo que permite la API de Airtable; los adjuntos llegan como enlaces.

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 token y ejecutarlo; el código también se muestra en la página del pedido.
• API oficialLa propia Web API de Airtable con su token
• Los campos que elijaUna tabla o una vista, solo los campos que necesita
• Sin duplicadosDesde Estándar, filas emparejadas por ID de registro
• Token fuera del códigoUsted lo 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 describe la base, las tablas y el sentido
2. 2
   CódigoEscribimos el script según la documentación de Airtable y la guía de instalación
3. 3
   PruébeloLo ejecuta con una copia de la base o una vista de prueba
4. 4
   CambiosPide cambios dentro de su paquete y nos envía cualquier mensaje de error

Qué necesitamos de usted

Las tablas o vistas de Airtable que sincronizar y una captura de sus campos con sus tipos (texto, número, fecha, selección única, registro vinculado, adjunto), la hoja a la que van y cómo deben nombrarse y ordenarse las columnas. Qué sentido necesita y, para la sincronización en ambos sentidos (Premium), qué lado prevalece cuando el mismo registro cambia en los dos sitios. Con qué frecuencia debe ejecutarse. Cree el token de acceso personal en su cuenta de Airtable; no nos lo envíe nunca.

Le preguntaremos:

• ¿Qué hay en la base de Airtable?
• ¿Qué sentido necesita?
• ¿Qué campos deben pasar?
• ¿Con qué frecuencia debe ejecutarse?

Comparar paquetes

Preguntas y respuestas

¿No encontró su respuesta? Pregúntenos