---
title: "sheet_diff"
description: "Compara duas versões de uma planilha (`.xlsx`) e lista cada mudança: valores, fórmulas e estilos das células, abas adicionadas, removidas ou renomeadas, e linhas ou colunas inseridas ou excluídas."
---

| Ferramenta | Tipo | Descrição |
| :-- | :-- | :-- |
| `sheet_diff` | leitura | Compara duas versões de uma planilha (`.xlsx`) e lista cada mudança: valores, fórmulas e estilos das células, abas adicionadas, removidas ou renomeadas, e linhas ou colunas inseridas ou excluídas, cada inserção ou exclusão como uma única mudança estrutural, como "3 linhas inseridas na 12", em vez de cada célula deslocada. Passe `fileId`, `fromVersion` e, se quiser, `toVersion` (padrão: a versão atual); `file_history` lista as versões. Cada aba alterada traz em `ranges` intervalos que cobrem todas as células alteradas, às vezes mais: depois de uma inserção ou exclusão de linhas ou colunas em qualquer aba, toda aba com fórmulas vem inteira (`A1:XFD1048576`), porque as fórmulas podem passar a apontar para outras células, e mudanças em estilos nomeados, formatos condicionais ou de tabela, no tema ou nas configurações da planilha também trazem a aba inteira; a mudança de estilo de uma célula, linha ou coluna traz só o intervalo dela; `details` traz o antes e o depois das primeiras células alteradas, até 16.000 caracteres, com `truncated: true` quando mudaram mais células do que `details` lista. O `at` de uma inserção é uma linha ou coluna de `toVersion`; o de uma exclusão, de `fromVersion`. Linhas ou colunas acrescentadas depois dos últimos dados contam como mudanças de células. |