# Google Tables {% hint style="warning" %} Este recurso está disponível na tarifa máxima {% endhint %} * Como preparar uma tabela do Google * Como escrever uma consulta JSON * Como escrever linhas em colunas específicas * Como registrar dados em células específicas * Como excluir registros de células específicas * Como escrever na primeira célula vazia de uma linha * Como ler dados da 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 remover completamente uma coluna (com deslocamento) * Como criar botões para selecionar uma planilha na tabela * Como trabalhar pela sua conta * Como trabalhar com letras de colunas * Como definir variáveis em nomes de colunas * Como excluir da tabela * Como adicionar uma planilha a uma tabela Possível erro Funções de Tabela do Google (APIs) Neste artigo, vamos ver como os bots podem interagir com tabelas do Google. **Para usar esta funcionalidade, você precisa:** * Tabela do Google, aberta para edição por link * Função de URL * Opções de consulta ## Como preparar uma tabela do Google !!! !!! !!! ## Como escrever uma consulta JSON Vá para as configurações do bloco no qual faremos o registro. Selecione o tipo de consulta POST-json, insira a URL da função que queremos, insira os parâmetros no campo JSON POST-parameters (Figura 5) Para ver qual resposta vem para sua solicitação, escreva no campo Resposta {custom\_answer}, salve e percorra a cadeia. Em seguida, você pode salvar cada valor da resposta em variáveis no campo Salvar valor da resposta JSON usando a sintaxe: > parameters\_from\_query -> sua\_variável Se vierem parâmetros complexos, então os desmembre da seguinte forma: > "cell\_number":{"row":4,"col":2} cell\_number|row -> Linha; cell\_number|col -> Coluna Agora vamos entender com mais detalhes o que os bots fazem com tabelas do Google. ## Como escrever linhas em colunas específicas Você pode coletar muitos dados do usuário e escrevê-los na primeira linha livre da tabela. Isso é feito usando o **mapeamento** função. {% hint style="warning" %} O cabeçalho deve ser preenchido (pelo menos uma célula na primeira linha) {% endhint %} Funções de URL: [https://store.salebot.pro/function/gsheets ]() Opções de consulta `{"id": "id da tabela", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":"apenas texto"}}}` Se você quiser escrever strings não na primeira planilha, deve adicionar o parâmetro list\_name à consulta: `{"id": "id da tabela", "mapping":{"a":"apenas texto", "b": "#{variable}"}, "list_name": "Nome da planilha"}` Onde id é o id da sua tabela do Google. Você pode obtê-lo pelo link da sua tabela do Google (o que está em negrito no link abaixo). a, b, c, d são apenas nomes de colunas list\_name - o nome da sua planilha (por exemplo, "Arquivo 2") Se não houver problema com a execução da consulta, a resposta será {"number\_row":8}. Você pode salvar esse número de linha e usá-lo em trabalhos posteriores. Se você não quiser correr o risco de restringir o acesso à sua tabela à sua conta, deve passar o parâmetro creds\_path da url do seu arquivo de dados. Mais sobre isso em Trabalhar pela sua conta: `{"id": "id da tabela", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":texto apenas"creds_": "caminho"caminho para o seu arquivo de dados para autorização"}}` ## Como registrar dados em células específicas Funções de URL: ; Opções `{"id": "id da tabela", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"apenas texto"}}. O registro é feito em células específicas que você indicar (no nosso exemplo a1, b3, c1, d20)` {% hint style="warning" %} A numeração das colunas começa em um. {% endhint %} Se você quiser escrever strings não na primeira planilha, deve adicionar o parâmetro list\_name à consulta: {"id": "id da tabela", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"apenas texto"}, "list\_name": "Nome do arquivo"}} Se não houver problema com a consulta, nenhum parâmetro é retornado. Se você não quiser correr o risco de restringir o acesso à sua tabela à sua conta, deve passar o parâmetro creds\_path da url do seu arquivo de dados. Mais sobre isso em Trabalhar pela sua conta: `{"id": "id da tabela", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"apenas texto}, "cred_name"Nome da planilha", s_"path": Caminho para o seu arquivo de dados com autorização}` !!! ## Como excluir registros de células específicas Funções de URL: ; `{"id": "id da tabela", "remove":[a1", "b3", "c2"]}. Remove valores de células específicas que você indicar (no nosso exemplo a1, b3, c2)` {% hint style="warning" %} A numeração das colunas começa com o número um. {% endhint %} Se você quiser remover células da primeira planilha, deve adicionar o parâmetro list\_name à consulta: `{"id": "id da tabela", "remove":[a1", "b3", "c2"], "list_name": "Nome do arquivo"}` Se não houver problema com a consulta, nenhum parâmetro é retornado. Se você não quiser correr o risco de restringir o acesso à sua tabela à sua conta, deve passar o parâmetro creds\_path da url do seu arquivo de dados. Mais sobre isso em Trabalhar pela sua conta: `{"id": "id da tabela", "remove":[a1", "b3", "c2"], "list_name": "Nome do arquivo","creds_path": "O caminho para o seu arquivo de dados para autorização"}` ## Como escrever na primeira célula vazia de uma linha Você pode escrever os dados na linha especificada; a entrada será feita em uma célula vazia à direita da última célula preenchida. Isso é realizado usando a função append\_in\_row. Funções de URL: ; Parâmetros da consulta {"id": "id da tabela", "append\_in\_row":"8", "value": "valor escrito"} Se você quiser escrever linhas não na primeira planilha, deve adicionar o parâmetro list\_name: {"id": "id da tabela", "append\_in\_row":", "value": "valor", "list\_name": "Nome da planilha"} Onde está o id da sua tabela do Google. Você pode obtê-lo pelo link da sua tabela do Google (o que está em negrito no link abaixo). append\_in\_row - número da linha para escrever value é o valor que será escrito na célula Se não houver problema com a execução da consulta, a resposta será {"number\_col":10,"col\_name":"J3"}. Você pode salvar esses números e usá-los em trabalhos posteriores. Se você não quiser correr o risco de restringir o acesso à sua tabela à sua conta, deve passar o parâmetro creds\_path da url do seu arquivo de dados. Para mais informações, veja Trabalhar pela sua conta: {"id": "id da tabela", "mapping":"{"a":"#{variable}", "b": "#{more}", "c": "#{more}, "cred"texto simples"},"s\_": caminho para seus dados com"path}" ## Como ler dados da tabela Funções de URL: {"id": "id da tabela", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Defina parâmetros para transmitir intervalos. No exemplo "a1":"a1" retorna uma célula e "c1":"c10" retorna 10 valores da coluna c. O valor hash retornado a partir do endereço da célula e os valores dela. {% hint style="warning" %} A numeração das colunas começa com o número um. {% endhint %} Se você quiser ler valores não na primeira planilha, deve adicionar o parâmetro list\_name à consulta: `{"id": "id da tabela", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Nome do arquivo"}` Se não houver problema com a consulta, o nome da célula e seu conteúdo serão retornados:"{"A1":" u043f u0440 u0438 u0432 u0435", "A2":" u043f u0440 u0430"U043U0A"U0A0430." U0440A0A"U0A0430." u0444 u0443 u043d u043a u0446"} Se você não quiser correr o risco de restringir o acesso à sua tabela à sua conta, deve passar o parâmetro creds\_path da url do seu arquivo de dados. Mais sobre isso em Trabalhar pela sua conta: {"id": "id da tabela", "read"::{"a1":"a3", "b3": "b6"}, "list\_name": "Nome da planilha","creds\_path": "caminho caminho caminho para o seu arquivo de dados para autorização"} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/pt/integrations/google/tables.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.