Skip to main content

Atualizar valores

Atualiza os valores de um intervalo de células.


Opções

Conexão do Google Sheets

Selecione a ação de Conexão configurada no fluxo.

ID da planilha

Informe o ID da planilha. O ID pode ser encontrado na URL da planilha: docs.google.com/spreadsheets/d/{spreadsheetId}/edit.

Intervalo

Notação A1 do intervalo a ser atualizado, ex.: Sheet1!A1:D10.

Valores

Monte a grade de valores a serem gravados no intervalo informado, organizados em linhas e colunas. Use os botões "Adicionar linha" e "Adicionar coluna" para expandir a grade conforme necessário. A quantidade de linhas/colunas preenchidas deve corresponder (ou ser compatível) com o intervalo informado.

Opções avançadas

Como interpretar os valores informados

Escolha entre Como se digitado por um usuário (fórmulas, datas etc. são interpretadas) ou Como texto puro (sem interpretação). Padrão: Como se digitado por um usuário.

Retornos

Código Javascript

actions["id-da-acao"].updatedRange // notação A1 do intervalo que foi atualizado (Texto)
actions["id-da-acao"].updatedRows // quantidade de linhas atualizadas (Número)
actions["id-da-acao"].updatedColumns // quantidade de colunas atualizadas (Número)
actions["id-da-acao"].updatedCells // quantidade de células atualizadas (Número)

Seleção de campos

  • updatedRange — notação A1 do intervalo que foi atualizado (Texto)
  • updatedRows — quantidade de linhas atualizadas (Número)
  • updatedColumns — quantidade de colunas atualizadas (Número)
  • updatedCells — quantidade de células atualizadas (Número)

Regras e Condições

  • Os campos Conexão do Google Sheets, ID da planilha e Intervalo são obrigatórios, assim como pelo menos uma linha e uma coluna de Valores.
  • O intervalo deve estar em notação A1 (ex.: Sheet1!A1:D10).
  • Por padrão os valores são interpretados como se digitados por um usuário (fórmulas, datas etc. são reconhecidas); é possível alternar para texto puro em Opções avançadas.
  • Se a grade de Valores tiver mais linhas/colunas do que o intervalo informado, o Google Sheets grava os valores extras a partir do início do intervalo, podendo sobrescrever células além do intervalo original.
  • Se o intervalo informado não puder ser resolvido (ex.: aba inexistente), o robô interrompe a execução com erro.