SHEETS_CLEAR - Limpar Dados do Google Sheets

O que é este Node?

O SHEETS_CLEAR é o node responsável por apagar o conteúdo de um range de células no Google Sheets, mantendo a formatação intacta.

Por que este Node existe?

Limpar dados mantendo estrutura é essencial em automações. O SHEETS_CLEAR existe para:

1. Reset de Dados Temporários: Limpar área de trabalho antes de nova operação
2. Limpeza de Cache: Remover dados processados após uso
3. Preparação de Relatórios: Limpar área antes de gerar novo relatório
4. Manutenção: Remover dados obsoletos periodicamente

Como funciona internamente?

Quando o SHEETS_CLEAR é executado, o sistema:

1. Autentica: Valida tokens OAuth2
2. Identifica range: Extrai spreadsheetId e range a limpar
3. Executa clear: Chama spreadsheets.values.clear()
4. Mantém formatação: Remove apenas valores, não formato/fórmulas da célula
5. Retorna confirmação: Informa qual range foi limpo
6. Se erro: Lança exceção

Código interno (google-executors.service.ts:800-809):

case 'clear':
  await sheets.spreadsheets.values.clear({
    spreadsheetId: data.spreadsheetId,
    range: data.range || 'Sheet1!A1:Z1000',
  });

  return {
    success: true,
    message: 'Range cleared successfully',
  };

Quando você DEVE usar este Node?

Use SHEETS_CLEAR quando precisar remover dados mantendo estrutura:

Casos de uso

1. Reset Diário: "Limpar planilha de pedidos do dia anterior"
2. Cache Temporário: "Remover dados de processamento após conclusão"
3. Área de Trabalho: "Limpar área de cálculos antes de nova operação"
4. Relatórios: "Apagar dados antigos antes de gerar novo relatório"

Quando NÃO usar SHEETS_CLEAR

• Deletar formatação também: Use operação de delete completo
• Remover linhas/colunas: Use operação de delete de dimensão
• Substituir dados: Use NODE SHEETS_WRITE diretamente

Parâmetros

Campo	Tipo	Obrigatório	Descrição
operation	string	Sim	Deve ser "clear"
spreadsheetId	string	Sim	ID da planilha
range	string	Não	Range a limpar (padrão: Sheet1!A1:Z1000)
accessToken	string	Sim	Token OAuth2
refreshToken	string	Sim	Token OAuth2 refresh

Exemplo 1: Limpar Cache de Processamento

Objetivo: Remover dados temporários após processamento

JSON para Importar

{
  "name": "Limpar Cache Temporário",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "sheets_1",
      "type": "google_sheets",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Limpar Cache",
        "parameters": {
          "operation": "clear",
          "spreadsheetId": "1Temp_Cache_XYZ",
          "range": "TempData!A2:Z1000",
          "accessToken": "{{google_access_token}}",
          "refreshToken": "{{google_refresh_token}}"
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "✅ Cache limpo com sucesso"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "sheets_1" },
    { "source": "sheets_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Saída esperada:

Sistema: ✅ Cache limpo com sucesso

Resposta do Node

{
  "success": true,
  "message": "Range cleared successfully"
}

Boas Práticas

✅ SIM:

• Sempre especifique range exato para evitar limpar dados importantes
• Mantenha cabeçalho (use A2:Z1000 ao invés de A1:Z1000)
• Faça backup antes de clear em dados críticos

❌ NÃO:

• Não use range muito amplo sem necessidade
• Não esqueça que clear remove APENAS valores, não formatação

Dicas

💡 Dica 1: Clear mantém bordas, cores e formatação. Remove apenas o conteúdo das células.

💡 Dica 2: Use ranges específicos: A2:C100 ao invés de A:Z para segurança.

Próximo Node

→ SHEETS_WRITE - Escrever novos dados → SHEETS_READ - Ler dados