Um Google Apps Script que carrega dados da API de um serviço na sua planilha do Google e os mantém atualizados

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

Pedidos da plataforma da sua loja, tarefas de um serviço de gestão de projetos, registros de um sistema de reservas: se o serviço tiver uma API pública, os dados podem chegar à sua planilha do Google sem exportar arquivos à mão. Este Google Apps Script envia uma requisição à API com a sua própria chave, pega os campos de que você precisa e os grava como linhas, página após página. A partir do Padrão, a chave fica nas propriedades do script, que você mesmo preenche, e não no código, e os erros vão para uma aba de Log; o Premium inclui só linhas novas ou alteradas e um guia para rodar a cada hora ou dia com um acionador. Envie um link para a documentação da API e os campos que você quer. Uma execução é limitada a cerca de seis minutos, então importações muito grandes vão em partes.

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 a sua chave e rodar; o código também aparece na página do pedido.
• Pela documentaçãoEscrito a partir da própria documentação da API
• Campos que você escolheSó as colunas de que você precisa, na sua ordem
• Todas as páginasResultados que vêm em páginas são lidos até o fim
• Chave fora do códigoVocê mesmo a coloca nas propriedades do script
• Código legívelCom comentários, fácil de incluir um campo depois

Como funciona

1. 1
   TarefaVocê envia a documentação da API e os campos de que precisa
2. 2
   CódigoEscrevemos o script pela documentação e o guia de instalação
3. 3
   TesteVocê coloca a sua chave em uma cópia da planilha e roda
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

O serviço e um link para a documentação da API, a requisição de que você precisa (por exemplo, pedidos dos últimos 30 dias) e os campos que devem virar colunas. Um exemplo da resposta da API ajuda muito: copie da documentação ou de uma chamada de teste, sem os valores confidenciais. Com que frequência os dados devem atualizar e se novas linhas são incluídas ou a aba é reescrita. Nunca envie a sua chave de API real: o README mostra onde colocá-la.

Vamos perguntar:

• Qual serviço e onde está a documentação da API dele?
• De quais dados você precisa?
• Com que frequência deve atualizar?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte