Ler Planilha

Visão Geral

O objeto Ler Planilha é utilizado para realizar a leitura de dados de uma planilha do Google Sheets, utilizando a API do Google Sheets.

Funcionamento

O objeto conecta-se a uma planilha do Google Sheets por meio de um Autenticador Google Sheets API e realiza a leitura dos dados da aba informada, retornando as informações conforme o Tipo de Retorno configurado.

Quando usar

Quando for necessário ler dados de uma planilha do Google Sheets.
Quando o robô precisar consumir informações armazenadas em uma aba específica.
Quando for necessário obter os dados da planilha para processamento no fluxo.

Quando não usar

Quando não houver autenticação válida da API do Google Sheets.
Quando o ID da planilha ou o nome da aba não estiverem definidos.
Quando não for necessário consumir dados da planilha.

Configuração

Campo

Descritivo

Título

É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Ler Planilha - Dados da Empresa".

Nome identificador objeto

É um identificador único do objeto e não precisa ser alterado, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais.

Autenticador Google Sheets API

Opção para selecionar objeto Autenticação do Google Sheets API.

ID da planilha

Opção para preencher o ID da planilha. Documentação ensinando.

Nome da Aba

Opção para preencher o nome da aba da planilha do Google Sheets que será modificada.

Ler Planilha Completa

Opção para leitura do documento Google Sheets inteiro.

Célula

Preencher com a célula unitária para leitura.

Selecionar Range

Marcar para preencher um alcance de Células na leitura

Coluna Inicial e Final

Preencher com a coluna inicial e final desejada.

Linha Inicial e Final

Preencher com a linha inicial e final desejada

Tipo de Retorno

Selecionar o tipo de retonor da informação. Json - Lista - Tabela de Dados

Retorno

Pré-requisitos

Para utilizar o objeto corretamente é necessário configurar o objeto Autenticação do Google Sheets API.
Para leitura de Lista utilizar Varrer Lista.
Para leitura de Tabela de Dados utilizar Varrer Tabela de Dados.

Casos de uso

Utilizar quando precisar ler as informações de um documento Google Sheets.

Id da planilha

Os objetos do Google Sheets API pedem o ID da planilha, para pegar ela basta verificar na sua URL, vejamos: Sempre vai ficar entre o /d/ e /edit...

Permissão para editar

As planilhas do google sheets precisam que o usuário principal de permissão ao usuário que foi criado dentro do projeto, ou seja, aquele e-mail longo em Credenciais.
Para isso basta ir em Compartilhar no canto superior direito e colocar o e-mail desejado.