Comparar a API REST com o serviço Formulários

Há alguma sobreposição entre o que você pode fazer com a API Google Forms e o serviço Forms no Apps Script. Este guia aborda semelhanças e diferenças para ajudar você a decidir qual é a melhor opção para seu projeto.

Recursos do Formulários compatíveis

A API REST e o serviço Forms no Apps Script oferecem recursos que o outro não tem. A lista exata de recursos compatíveis muda com o tempo. Consulte o restante da documentação para saber se um recurso específico é compatível.

A API REST não é compatível com o seguinte:

  • Envio de respostas do formulário
  • Incluir dados detalhados de formulários ou respostas no corpo das notificações de publicação/assinatura

O serviço Formulários no Apps Script não é compatível com o seguinte:

  • Como se inscrever em eventos de formulário com o Cloud Pub/Sub
  • Definir respostas corretas para tipos de perguntas que não são de múltipla escolha

Solicitar um novo recurso da API REST

A API REST é mais recente que o serviço Forms no Apps Script, e novos recursos são adicionados regularmente. Envie um pedido de recurso se quiser que um recurso específico seja priorizado.

Comportamento baseado em eventos

Os acionadores do {apps_script_name_short} e o recurso forms.watches na API REST permitem tomar medidas quando um formulário muda.

Prefira o forms.watches da API REST para:

  • Máxima confiabilidade
  • Interoperabilidade com o Cloud Pub/Sub
  • Notificações quando os formulários são editados

Prefira acionadores do Apps Script para:

  • Dados do formulário ou da resposta incluídos em cada notificação
  • Gatilhos baseados em tempo

Cotas

O Apps Script e a API Forms têm limites de serviço diferentes.

Idiomas e ambientes

Se você preferir desenvolver em JavaScript, o Apps Script pode economizar tempo automatizando a configuração de um projeto do console do Google Cloud e um fluxo de consentimento do OAuth. O Apps Script também oferece um editor de código baseado em navegador e executa seu código nos servidores do Google.

Por outro lado, a API REST oferece bibliotecas de cliente em várias linguagens além do JavaScript, permitindo que você desenvolva na linguagem de sua escolha e não esteja sujeito a limites de tempo de execução ou execuções simultâneas.

Usar a API REST do Apps Script

Se você preferir o ambiente de desenvolvimento do Apps Script, mas quiser usar os recursos da API REST Forms, faça isso usando UrlFetchApp. Para mais informações, consulte Configurar um projeto do Apps Script.

A API REST do Formulários ainda não está disponível como um serviço avançado do Apps Script. Envie uma solicitação de recurso se quiser que ele seja compatível.

Próximas etapas