---
title: "sheet_write"
description: "Aplica um ou mais patches (`patches[]`) a um workbook existente, preserva células e abas fora deles, exige `baseVersion` e acrescenta uma versão ao mesmo id de arquivo; se o conteúdo, o tipo de mídia e o nome forem idênticos, não acrescenta versão e retorna `unchanged: true`."
---

| Ferramenta | Tipo | Descrição |
| :-- | :-- | :-- |
| `sheet_write` | escrita | Aplica um ou mais patches (`patches[]`) a um workbook existente, preserva células e abas fora deles, exige `baseVersion` e acrescenta uma versão ao mesmo id de arquivo; se o conteúdo, o tipo de mídia e o nome forem idênticos, não acrescenta versão e retorna `unchanged: true`. A resposta traz `source` na versão de origem e `file` na versão resultante. Em caso de `conflict`, releia a versão atual e refaça a edição. Um patch de células `{ sheet, range, cells }` escreve um intervalo A1; um patch de consulta `{ sheet, anchor, query }` (também exige `files:read`) roda um `SELECT` do `sql` e escreve todas as linhas a partir da célula `anchor`, mantendo a formatação do modelo, sem que os dados passem pelo agente. Patches não podem se sobrepor. |