Este recurso está disponível no tarifário máximo.

Conteúdo

  • Como preparar uma Google Sheet
  • Como escrever uma consulta JSON
  • Como escrever linhas em colunas específicas
  • Como escrever dados em células específicas
  • Como excluir dados de células específicas
  • Como escrever na primeira célula vazia de uma linha
  • Como ler dados de uma tabela
  • Como encontrar texto em uma tabela (retornar a primeira linha correspondente)
  • Como listar todas as correspondências em uma tabela
  • Como excluir completamente uma linha (com deslocamento)
  • Como excluir completamente uma coluna (com deslocamento)
  • Como criar botões para selecionar uma planilha em uma tabela
  • Como trabalhar através da sua conta
  • Como trabalhar com letras de colunas
  • Como definir variáveis em nomes de colunas
  • Como excluir dados de uma tabela
  • Como adicionar uma planilha a uma tabela
  • Erros potenciais
  • Funções do Google Sheets (API)

Neste artigo, veremos como os bots podem interagir com o Google Sheets.

Para usar esta funcionalidade, você precisa:

  • Uma Google Sheet com acesso de edição habilitado via link
  • Uma URL de função
  • Parâmetros de consulta

Como escrever uma consulta JSON

Vá para as configurações do bloco do qual deseja enviar a solicitação.

Selecione o tipo de solicitação POST JSON, insira a URL da função necessária e adicione os parâmetros ao campo Parâmetros JSON POST.

Para ver a resposta retornada pela sua solicitação, insira {custom_answer} no campo Resposta, salve o bloco e execute a cadeia.

Você pode então salvar valores individuais da resposta em variáveis no campo Salvar valor da resposta JSON usando a seguinte sintaxe:

parameters_from_query -> your_variable

Se a resposta contiver parâmetros aninhados, extraia-os da seguinte forma.

Por exemplo, se a resposta for:

{
  "cell_number": {
    "row": 4,
    "col": 2
  }
}

Use:

cell_number|row -> Row
cell_number|col -> Column

Agora vamos analisar em mais detalhes o que os bots podem fazer com o Google Sheets.

Como escrever linhas em colunas específicas

Você pode coletar dados de um usuário e escrevê-los na primeira linha disponível da tabela. Isso é feito usando a função mapping.

O cabeçalho deve ser preenchido — pelo menos uma célula na primeira linha deve conter um valor.

URL da função:

https://store.mavibot.ai/function/gsheets

Parâmetros de consulta:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  }
}

Se você quiser escrever dados em uma planilha diferente da primeira, adicione o parâmetro list_name:

{
  "id": "table id",
  "mapping": {
    "a": "just text",
    "b": "#{variable}"
  },
  "list_name": "Sheet name"
}

Onde:

  • id — o ID da sua Google Sheet. Você pode obtê-lo na URL do Google Sheets.
  • a, b, c, d — nomes das colunas.
  • list_name — o nome da planilha, por exemplo "Sheet 2".

Exemplo de URL do Google Sheets:

https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

Neste exemplo, o ID da tabela é:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Se a solicitação for concluída com sucesso, a resposta será assim:

{
  "number_row": 8
}

Você pode salvar o número da linha retornado e usá-lo posteriormente.

Se você não quiser tornar a tabela publicamente editável via link, você precisa passar o parâmetro creds_path com o caminho para o seu arquivo de dados de autorização.

Para mais informações, consulte a seção Trabalhar através da sua conta.

Exemplo:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  },
  "creds_path": "path to your authorization data file"
}

Como escrever dados em células específicas

URL da função:

https://store.mavibot.ai/function/gsheets

Parâmetros de consulta:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  }
}

Os dados são escritos nas células específicas que você fornece — neste exemplo: A1, B3, C1 e D20.

A numeração das colunas começa em 1.

Se você quiser escrever dados em uma planilha diferente da primeira, adicione o parâmetro list_name:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  },
  "list_name": "Sheet name"
}

Se a solicitação for concluída com sucesso, nenhum parâmetro será retornado.

Se você não quiser tornar a tabela publicamente editável via link, passe o parâmetro creds_path com o caminho para o seu arquivo de dados de autorização.

Para mais informações, consulte a seção Trabalhar através da sua conta.

Exemplo:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{more}",
    "d20": "just text"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

Como excluir dados de células específicas

URL da função:

https://store.mavibot.ai/function/gsheets

Parâmetros de consulta:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ]
}

Isso remove valores das células especificadas — neste exemplo: A1, B3 e C2.

A numeração das colunas começa em 1.

Se você quiser remover valores de células em uma planilha diferente da primeira, adicione o parâmetro list_name:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name"
}

Se a solicitação for concluída com sucesso, nenhum parâmetro será retornado.

Se você não quiser tornar a tabela publicamente editável via link, passe o parâmetro creds_path com o caminho para o seu arquivo de dados de autorização.

Para mais informações, consulte a seção Trabalhar através da sua conta.

Exemplo:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}

Como escrever na primeira célula vazia de uma linha

Você pode escrever dados em uma linha especificada. O valor será adicionado à primeira célula vazia à direita da última célula preenchida.

Isso é feito usando a função append_in_row.

URL da função:

https://store.mavibot.ai/function/gsheets

Parâmetros de consulta:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value"
}

Se você quiser escrever dados em uma linha em uma planilha diferente da primeira, adicione o parâmetro list_name:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "list_name": "Sheet name"
}

Onde:

  • id — o ID da sua Google Sheet.
  • append_in_row — o número da linha onde o valor deve ser escrito.
  • value — o valor que será escrito na célula.
  • list_name — o nome da planilha.

Se a solicitação for concluída com sucesso, a resposta será assim:

{
  "number_col": 10,
  "col_name": "J3"
}

Você pode salvar os valores retornados e usá-los posteriormente.

Se você não quiser tornar a tabela publicamente editável via link, passe o parâmetro creds_path com o caminho para o seu arquivo de dados de autorização.

Exemplo:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "creds_path": "path to your authorization data file"
}

Como ler dados da tabela

URL da função:

https://store.mavibot.ai/function/gsheets

Parâmetros de consulta:

{
  "id": "table id",
  "read": {
    "a1": "a1",
    "b3": "b4",
    "c1": "c10",
    "d20": "a1"
  }
}

Use o parâmetro read para especificar os intervalos que deseja recuperar.

Por exemplo:

  • "a1": "a1" retorna uma célula.
  • "c1": "c10" retorna 10 valores da coluna C.

A resposta contém os endereços das células e seus valores.

A numeração das colunas começa em 1.

Se você quiser ler valores de uma planilha diferente da primeira, adicione o parâmetro list_name:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name"
}

Se a solicitação for concluída com sucesso, a resposta conterá os nomes das células e seus valores.

Exemplo:

{
  "A1": "value 1",
  "A2": "value 2",
  "A3": "value 3"
}

Se você não quiser tornar a tabela publicamente editável via link, passe o parâmetro creds_path com o caminho para o seu arquivo de dados de autorização.

Para mais informações, consulte a seção Trabalhar através da sua conta.

Exemplo:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name",
  "creds_path": "path to your authorization data file"
}