Conecta-seEntrar na plataforma

Google AppSheet

Consultar, adicionar, editar e excluir linhas de uma tabela do Google AppSheet.

Integrações e ferramentasBancos de dadosConexão: Credencial protegida

O que faz

Integre o Google AppSheet ao seu fluxo. Busque, adicione, edite e exclua linhas de uma tabela do AppSheet pela API do AppSheet. Exige um plano AppSheet Enterprise com a API ativada e uma Application Access Key.

Quando usar: Use quando o seu fluxo precisar consultar, adicionar, editar e excluir linhas de uma tabela do Google AppSheet.

Exemplo de situação: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Google AppSheet ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Buscar linhasBusca linhas com o bloco Google AppSheet.
Adicionar linhasAdiciona linhas com o bloco Google AppSheet.
Editar linhasEdita linhas com o bloco Google AppSheet.
Excluir linhasExclui linhas com o bloco Google AppSheet.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Buscar linhas · Adicionar linhas · Editar linhas · Excluir linhas
    Padrão:
    Buscar linhas

  • ID do app

    Obrigatório

    App > Settings > Integrations > IN.

    Exemplo:
    id-do-recurso

  • Nome da tabela

    Obrigatório

    Define o nome ou título usado para identificar o recurso.

    Exemplo:
    Exemplo de atendimento

  • Seletor

    Em campos adicionais

    Expressão opcional, ex.: Filter(Pedidos, [Status] = "Aberto") ou Top(OrderBy(Filter(Pedidos, true), [Data], true), 10).

    Aparece em:
    Buscar linhas
    Exemplo:
    Filter(Pedidos, [Status] = "Aberto") ou Top(OrderBy(Filter(Pedidos, true), [Data], true), 10

  • Linhas (lista JSON)

    Obrigatório conforme a operação

    Para adicionar: `[{ "FirstName": "Jan", "LastName": "Jones" }]`.

    Aparece em:
    Adicionar linhas, Editar linhas, Excluir linhas
    Exemplo:
    { "chave": "valor" }

  • Região

    Em campos adicionais

    Escolhe uma das opções aceitas por este campo.

    Opções:
    Global (www) · Europa (eu) · Ásia-Pacífico (asia-southeast)
    Padrão:
    Global (www)

  • Chave de acesso do aplicativo (Application Access Key)

    ObrigatórioDado protegido

    Informe a Application Access Key do seu AppSheet.

    Padrão:
    Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <googleappsheet.rows>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<googleappsheet.rows>jsonLinhas retornadas pela operação do AppSheet: [{ columnName: value, ... }].
<googleappsheet.metadata>jsonMetadados da operação: { rowCount: number }.

Exemplo de uso

Objetivo: Localizar um cadastro e aproveitar seus dados nas etapas seguintes.

InícioGoogle AppSheetpróxima etapa
Operação
Buscar linhas
ID do app
id-do-recurso
Nome da tabela
Exemplo de atendimento

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <googleappsheet.rows>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
Não foi possível conectar ao banco
Confira endereço, porta, nome do banco e usuário da conexão, e se o banco aceita conexões vindas da plataforma (firewall e lista de IPs liberados).
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados