Um Google Apps Script que copia registros entre a sua base do Airtable e uma planilha do Google, em uma ou nas duas direções

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    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}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Algumas pessoas de um projeto trabalham no Airtable, outras só no Planilhas Google, e copiar registros entre os dois dá errado mais cedo ou mais tarde. Este Google Apps Script lê a sua base do Airtable pela API oficial com o seu próprio token de acesso pessoal e grava os registros que você escolher em uma planilha: uma tabela ou uma visualização, os campos de que você precisa como colunas. A partir do Padrão, ele guarda o ID do registro em cada linha, então uma segunda execução atualiza as linhas em vez de duplicá-las, e mostra os registros vinculados como nomes. O Premium envia as edições da planilha de volta para o Airtable pela regra que você definir sobre qual lado prevalece. O seu token vai para as propriedades do script, que você mesmo preenche, nunca para o código. Ele roda no ritmo que a API do Airtable permite; os anexos vêm como links.

O que está incluído

• O que você recebeUm arquivo ZIP com o código do Apps Script e um README que mostra como adicioná-lo à sua planilha, colocar o seu token e rodar; o código também aparece na página do pedido.
• API oficialA própria Web API do Airtable com o seu token
• Campos que você escolheUma tabela ou uma visualização, só os campos de que você precisa
• Sem duplicadosA partir do Padrão, linhas associadas pelo ID do registro
• Token fora do códigoVocê o coloca nas propriedades do script
• Código legívelCom comentários, fácil de incluir um campo depois

Como funciona

1. 1
   TarefaVocê descreve a base, as tabelas e a direção
2. 2
   CódigoEscrevemos o script pela documentação do Airtable e o guia de instalação
3. 3
   TesteVocê roda em uma cópia da base ou em uma visualização de teste
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

As tabelas ou visualizações do Airtable a sincronizar e uma captura de tela dos campos com os tipos (texto, número, data, seleção única, registro vinculado, anexo), a planilha para onde vão e como as colunas devem ser nomeadas e ordenadas. Qual direção você precisa e, para a sincronização nas duas direções (Premium), qual lado prevalece quando o mesmo registro muda nos dois lugares. Com que frequência ele deve rodar. Crie o token de acesso pessoal na sua conta do Airtable; nunca o envie para nós.

Vamos perguntar:

• O que há na base do Airtable?
• Qual direção você precisa?
• Quais campos devem vir?
• Com que frequência ele deve rodar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte