> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/google-spreadsheet.md).

# Google Spreadsheet

<figure><img src="/files/aiuDwWdHfeiz1Yrco7X4" alt=""><figcaption></figcaption></figure>

A **Google Spreadsheet** no **Gaio DataOS** permite importar dados diretamente de uma planilha pública do **Google Sheets** para dentro do seu fluxo de dados. Ela é ideal para cenários de colaboração em tempo real, quando os dados são gerenciados externamente por outros times, clientes ou sistemas compartilhados.

***

## Como usar

### 1. Abrir a task

Navegue até:\
**Tasks > ETL > Google Spreadsheet**

***

### 2. Preencher os detalhes da task

* **Rótulo (opcional):** Nome para identificar esta task no fluxo\
  (ex.: *Import Client Sheet*).
* **Tabela Resultado:** Nome da tabela que será criada ou atualizada com os dados importados.
* **Full URL or DOC output ID:**\
  Informe o link público completo da planilha ou apenas o **ID do documento**\
  (ex.: `1aB2C3D4E5FgHiJ`).

**Requisitos importantes**

* A planilha deve estar **publicamente acessível**\
  \&#xNAN;*(Qualquer pessoa com um link pode ver).*
* A **primeira linha** deve conter os nomes das colunas.
* Evite espaços em branco ou caracteres especiais nos nomes das colunas para melhor compatibilidade.

***

### 3. Configurar o modo de inserção (opcional)

* **Insert mode: append records to tabela**
  * **Habilitado:** Os novos dados serão adicionados à tabela existente.
  * **Desabilitado:** A tabela será sobrescrita com o conteúdo atual da planilha.

***

### 4. Salvar e executar

* Clique em **Save** para adicionar a task ao fluxo.
* Quando executada, a planilha será buscada e carregada na tabela especificada.

***

### Casos de uso

* Importar listas ou formulários compartilhados por times externos ou clientes
* Conectar planilhas mantidas por áreas de negócio (marketing, vendas, financeiro, etc.)
* Automatizar relatórios baseados em Google Sheets atualizados manualmente
* Integrar dados de sistemas legados compartilhados via Google Sheets