# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/google-spreadsheet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.