Conecta-seEntrar na plataforma

Google Forms

Administrar formulários e respostas do Google Forms.

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

O que faz

Integre o Google Forms ao seu fluxo. Leia a estrutura de formulários, obtenha respostas, crie formulários, atualize o conteúdo e gerencie monitoramentos de notificações.

Quando usar: Use quando o seu fluxo precisar administrar formulários e respostas do Google Forms.

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 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. 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.

Para configurar o gatilho

  1. Abra o seu formulário no Google Forms → Mais (⋮) → Editor de script.
  2. Cole o trecho de Apps Script abaixo em Code.gs (ou Código.gs) → Salvar.
  3. Acionadores (ícone de relógio) → Adicionar acionador → Função: onFormSubmit → Origem do evento: Do formulário → Tipo de evento: Ao enviar o formulário → Salvar.
  4. Autorize quando for solicitado. Envie uma resposta de teste e confira a execução nos registros de atividade da plataforma.

Operações

OperaçãoO que faz
Ler respostas do formulárioLê respostas do formulário com o bloco Google Forms.
Consultar perguntas do formulárioConsulta perguntas do formulário com o bloco Google Forms.
Criar formulárioCria formulário com o bloco Google Forms.
Editar perguntas (JSON avançado)Edita perguntas (JSON avançado) com o bloco Google Forms.
Publicar ou fechar formulárioPublica ou fechar formulário com o bloco Google Forms.
Criar notificação via Pub/SubCria notificação via Pub/Sub com o bloco Google Forms.
Listar notificações configuradasLista notificações configuradas com o bloco Google Forms.
Excluir notificaçãoExclui notificação com o bloco Google Forms.
Renovar notificaçãoRenova notificação com o bloco Google Forms.

Campos

Mostrar campos de

  • O que fazer

    Escolhe qual ação este bloco executará.

    Opções:
    Ler respostas do formulário · Consultar perguntas do formulário · Criar formulário · Editar perguntas (JSON avançado) · Publicar ou fechar formulário · Criar notificação via Pub/Sub · Listar notificações configuradas · Excluir notificação · Renovar notificação
    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 “Criar formulário”
    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 “Criar formulário”
    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'

  • Título do formulário

    Obrigatório conforme a operação

    Informe o título do formulário.

    Aparece em:
    Criar formulário
    Exemplo:
    Exemplo de atendimento

  • Título do documento

    Título exibido no Drive (opcional).

    Aparece em:
    Criar formulário
    Exemplo:
    Exemplo de atendimento

  • Criar sem publicar

    Ativa ou desativa este comportamento.

    Aparece em:
    Criar formulário
    Exemplo:
    false

  • Alterações nas perguntas (JSON)

    Obrigatório conforme a operação

    Lista de operações batchUpdate da API Google Forms. Para uma pergunta simples, use os blocos Adicionar pergunta.

    Aparece em:
    Editar perguntas (JSON avançado)
    Exemplo:
    { "chave": "valor" }

  • Incluir o formulário na resposta

    Ativa ou desativa este comportamento.

    Aparece em:
    Editar perguntas (JSON avançado)
    Exemplo:
    false

  • Publicado

    Obrigatório conforme a operação

    Ativa ou desativa este comportamento.

    Aparece em:
    Publicar ou fechar formulário
    Exemplo:
    false

  • Aceitando respostas

    Ativa ou desativa este comportamento.

    Aparece em:
    Publicar ou fechar formulário
    Exemplo:
    false

  • Tipo de evento

    Obrigatório conforme a operação

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

    Aparece em:
    Criar notificação via Pub/Sub
    Opções:
    Respostas do formulário · Mudanças na estrutura do formulário
    Exemplo:
    Respostas do formulário

  • Tópico do Pub/Sub

    Obrigatório conforme a operação

    Recurso avançado: tópico Google Cloud Pub/Sub com permissão de publicação para o Google Forms. Não é uma URL de webhook.

    Aparece em:
    Criar notificação via Pub/Sub
    Exemplo:
    Exemplo de atendimento

  • ID do monitoramento

    Obrigatório conforme a operação

    ID personalizado do monitoramento (opcional).

    Aparece em:
    Criar notificação via Pub/Sub, Excluir notificação, Renovar notificação
    Exemplo:
    id-do-recurso

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