Conecta-seEntrar na plataforma

Google Sheets

Ler, escrever e atualizar dados em planilhas do Google Sheets.

Integrações e ferramentasArquivos e documentosConexão: OAuth

O que faz

Integre o Google Sheets ao fluxo. Permite ler, gravar, acrescentar e atualizar dados.

Quando usar: Use quando o seu fluxo precisar ler, escrever e atualizar dados em planilhas do Google Sheets.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Google Sheets ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Ler dadosLê dados com o bloco Google Sheets.
Gravar dadosGrava dados com o bloco Google Sheets.
Atualizar dadosAtualiza dados com o bloco Google Sheets.
Acrescentar dadosAcrescenta dados com o bloco Google Sheets.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Ler dados · Gravar dados · Atualizar dados · Acrescentar dados
    Padrão:
    Ler dados

  • Conta do Google

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Google

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Conta representada

    E-mail do usuário a representar (para contas de serviço).

    Exemplo:
    cliente@exemplo.com

  • Selecionar planilha

    Selecione uma planilha.

    Exemplo:
    (escolha na lista do campo)

  • ID da planilha

    Em campos adicionais

    ID da planilha (tirado da URL).

    Exemplo:
    id-do-recurso

  • Intervalo

    Nome da aba e intervalo de células (ex.: Sheet1!A1:D10).

    Exemplo:
    A1:D20

  • Valores

    Obrigatório conforme a operação

    Informe os valores como uma lista de listas em JSON (ex.: [["A1", "B1"], ["A2", "B2"]]) ou como uma lista de objetos (ex.: [{"name":"João", "age":30}, {"name":"Maria", "age":25}]).

    Aparece em:
    Gravar dados
    Exemplo:
    150.00

  • Modo de entrada dos valores

    Define se a planilha interpreta fórmulas e formatos ou grava o valor exatamente como foi enviado.

    Aparece em:
    Gravar dados
    Opções:
    Como digitado (interpretar fórmulas) · Bruto (não interpretar fórmulas)
    Exemplo:
    Como digitado (interpretar fórmulas)

  • Modo de inserção dos dados

    Define se novos dados criam linhas ou substituem a área existente da planilha.

    Aparece em:
    Acrescentar dados
    Opções:
    Inserir linhas (adiciona novas linhas) · Sobrescrever (grava sobre os dados existentes)
    Exemplo:
    Inserir linhas (adiciona novas linhas)

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googlesheets.data>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<googlesheets.data>jsonDados da planilha.
<googlesheets.metadata>jsonMetadados da operação.
<googlesheets.updatedRange>stringIntervalo atualizado.
<googlesheets.updatedRows>numberNúmero de linhas atualizadas.
<googlesheets.updatedColumns>numberNúmero de colunas atualizadas.
<googlesheets.updatedCells>numberNúmero de células atualizadas.
<googlesheets.tableRange>stringIntervalo da tabela.

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioGoogle Sheetspróxima etapa
Operação
Ler dados
Conta do Google
(escolha a conta conectada)
Conta representada
cliente@exemplo.com
Selecionar planilha
(escolha na lista do campo)
Intervalo
A1:D20

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googlesheets.data>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados