Conecta-seEntrar na plataforma

Ler respostas do formulário · Google Forms

Ler respostas do formulário usando a conexão Google Forms deste workspace.

Integrações e ferramentasArquivos e documentosConexão: OAuth

O que faz

Ler respostas do formulário usando a conexão Google Forms deste workspace.

Quando usar: Use quando o seu fluxo precisar Ler respostas do formulário usando a conexão Google Forms deste workspace..

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Ler respostas do formulário · Google Forms ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Revise a ação principal descrita no cartão do bloco.
  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
Ler respostas do formulárioLê respostas do formulário com o bloco Ler respostas do formulário · Google Forms.

Campos

Mostrar campos de

  • O que fazer

    Escolhe qual ação este bloco executará.

    Opções:
    Ler respostas do formulário
    Padrão:
    Ler respostas do formulário

  • Conta do Google

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Google

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Conta representada

    E-mail do usuário a representar (para contas de serviço).

    Exemplo:
    cliente@exemplo.com

  • Formulário

    Obrigatório conforme a operação

    Selecione um formulário.

    Quando aparece:
    Quando o campo “O que fazer” for diferente de “create_form”
    Exemplo:
    (escolha na lista do campo)

  • ID do formulário

    Obrigatório conforme a operaçãoEm campos adicionais

    Informe o ID do formulário do Google.

    Quando aparece:
    Quando o campo “O que fazer” for diferente de “create_form”
    Exemplo:
    id-do-recurso

  • Resposta específica (opcional)

    Deixe vazio para listar as respostas. Use o ID apenas para consultar uma resposta específica.

    Aparece em:
    Ler respostas do formulário
    Exemplo:
    id-do-recurso

  • Itens por página

    Em campos adicionais

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Ler respostas do formulário
    Exemplo:
    10

  • Token da página

    Em campos adicionais

    Token retornado na requisição anterior, para buscar a próxima página.

    Aparece em:
    Ler respostas do formulário
    Exemplo:
    Token retornado na requisição anterior, para buscar a próxima página

  • Filtro por data (opcional)

    Em campos adicionais

    Para buscar respostas recentes: timestamp > 2026-01-01T00:00:00Z. Deixe vazio para todas.

    Aparece em:
    Ler respostas do formulário
    Exemplo:
    status = 'ativo'

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 <lerrespostasdoformulariogoogleforms.responses>: 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
<lerrespostasdoformulariogoogleforms.responses>jsonLista de respostas do formulário.
<lerrespostasdoformulariogoogleforms.nextPageToken>stringToken para buscar a próxima página de respostas.
<lerrespostasdoformulariogoogleforms.response>jsonUma única resposta do formulário.
<lerrespostasdoformulariogoogleforms.formId>stringID do formulário.
<lerrespostasdoformulariogoogleforms.title>stringTítulo do formulário.
<lerrespostasdoformulariogoogleforms.description>stringDescrição do formulário.
<lerrespostasdoformulariogoogleforms.documentTitle>stringTítulo do documento no Drive.
<lerrespostasdoformulariogoogleforms.responderUri>stringURL para responder ao formulário.
<lerrespostasdoformulariogoogleforms.linkedSheetId>stringID da planilha Google vinculada.
<lerrespostasdoformulariogoogleforms.revisionId>stringID da versão do formulário.
<lerrespostasdoformulariogoogleforms.items>jsonItens do formulário (perguntas, seções etc.).
<lerrespostasdoformulariogoogleforms.settings>jsonConfigurações do formulário.
<lerrespostasdoformulariogoogleforms.publishSettings>jsonConfigurações de publicação do formulário.
<lerrespostasdoformulariogoogleforms.replies>jsonRetorno de cada solicitação de atualização.
<lerrespostasdoformulariogoogleforms.writeControl>jsonControle de gravação com os IDs de versão.
<lerrespostasdoformulariogoogleforms.form>jsonFormulário atualizado (se includeFormInResponse for verdadeiro).
<lerrespostasdoformulariogoogleforms.watches>jsonLista de monitoramentos do formulário.
<lerrespostasdoformulariogoogleforms.id>stringID do monitoramento.
<lerrespostasdoformulariogoogleforms.eventType>stringTipo de evento do monitoramento.
<lerrespostasdoformulariogoogleforms.topicName>stringTópico do Cloud Pub/Sub.
<lerrespostasdoformulariogoogleforms.createTime>stringData e hora de criação do monitoramento.
<lerrespostasdoformulariogoogleforms.expireTime>stringData e hora de expiração do monitoramento.
<lerrespostasdoformulariogoogleforms.state>stringEstado do monitoramento (ACTIVE, SUSPENDED).
<lerrespostasdoformulariogoogleforms.deleted>booleanIndica se o monitoramento foi excluído.

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioLer respostas do formulário · Google Formspróxima etapa
O que fazer
Ler respostas do formulário
Conta do Google
(escolha a conta conectada)
Conta representada
cliente@exemplo.com
Formulário
(escolha na lista do campo)
Resposta específica (opcional)
id-do-recurso

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 <lerrespostasdoformulariogoogleforms.responses>. 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”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
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