Buscar Células por Valor

Visão Geral

O objeto Buscar Células por Valor é utilizado para localizar células em uma planilha do Google Sheets a partir de um valor informado, 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 busca de células que contenham o Valor de busca informado, respeitando as opções de verificação configuradas.

Quando usar

Quando for necessário localizar células com base em um valor específico.
Quando o robô precisar identificar a posição de dados em uma planilha do Google Sheets.

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 houver um valor para busca.

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: "Buscar Células por Valor - 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.

Valor da Busca

Preencher o valor que será buscado no documento.

Verificar se contém o valor

Opção para verificar na busca se contém o valor desejado no documento.

Ignorar maiúsculas e minúsculas

Opção para buscar independente de tamanho de letra.

Parar a busca ao encontrar o valor

Opção para quando encontrar o valor desejado seja parada a busca.

Retorno

Pré-requisitos

Para utilizar o objeto corretamente é necessário configurar o objeto Autenticação do Google Sheets API.

Casos de uso

Utilizar quando precisar buscar valores dentro 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.