Gravar dados · Google Sheets
Gravar dados usando a conexão Google Sheets deste workspace.
O que faz
Gravar dados usando a conexão Google Sheets deste workspace.
Quando usar: Use quando o seu fluxo precisar Gravar dados usando a conexão Google Sheets deste workspace..
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
- Adicione Gravar dados · Google Sheets ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Gravar dados | Grava dados com o bloco Gravar dados · Google Sheets. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Gravar dados
- Padrão:
- Gravar dados
Conta do Google
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Google
ObrigatórioEm campos adicionaisInforma 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 adicionaisID 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çãoInforme 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)
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 <gravardadosgooglesheets.data>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<gravardadosgooglesheets.data> | json | Dados da planilha. |
<gravardadosgooglesheets.metadata> | json | Metadados da operação. |
<gravardadosgooglesheets.updatedRange> | string | Intervalo atualizado. |
<gravardadosgooglesheets.updatedRows> | number | Número de linhas atualizadas. |
<gravardadosgooglesheets.updatedColumns> | number | Número de colunas atualizadas. |
<gravardadosgooglesheets.updatedCells> | number | Número de células atualizadas. |
<gravardadosgooglesheets.tableRange> | string | Intervalo da tabela. |
Exemplo de uso
Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.
- Operação
- Gravar dados
- Conta do Google
- (escolha a conta conectada)
- Conta representada
- cliente@exemplo.com
- Selecionar planilha
- (escolha na lista do campo)
- Intervalo
- A1:D20
- Valores
- 150.00
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 <gravardadosgooglesheets.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
- Acrescentar dados · Google SheetsAcrescentar dados usando a conexão Google Sheets deste workspace.
- Adicionar pergunta de múltipla escolha · Google FormsGerencie formulários e respostas do Google Forms.
- Adicionar pergunta de texto · Google FormsGerencie formulários e respostas do Google Forms.
- Aplicar estilo de parágrafo · Google DocsAplicar estilo de parágrafo usando a conexão Google Docs deste workspace.
- Aplicar estilo de texto · Google DocsAplicar estilo de texto usando a conexão Google Docs deste workspace.
- Atualizar arquivo · Google DriveAtualizar arquivo usando a conexão Google Drive deste workspace.