Esta página oferece uma visão geral do exemplo de app da Web do Apps Script para a API Google Forms.
Pré-requisitos
- Ative a API Forms no seu projeto do Google Cloud.
- Configure um novo projeto do Apps Script conforme descrito no arquivo README do GitHub para o web app de exemplo.
Visão geral
A API Forms permite que qualquer cliente autenticado acesse a API diretamente usando REST.
Como o Apps Script oferece uma maneira de obter um token de acesso OAuth válido e fazer chamadas REST, é possível integrar o Apps Script diretamente à API Forms. O Apps Script já oferece um serviço de formulários (link em inglês) que permite que os scripts criem, acessem e modifiquem formulários. No entanto, se você preferir usar a API Forms diretamente do Apps Script, configure o acesso OAuth da seguinte maneira:
Receba um token de acesso do OAuth autenticado e com escopo.
ScriptApp.getOAuthToken();Inclua o token do OAuth no argumento options fornecido em qualquer chamada REST para a API.
UrlFetchApp.fetch(Url, options);
Consulte Configurar um projeto do Apps Script para ver um exemplo disso em ação. O guia de configuração detalha a infraestrutura necessária para chamar a API. No entanto, para oferecer acesso intuitivo à API para usuários, você também pode testar e modificar nosso app da Web de exemplo.
Exemplo de uso do web app
Um exemplo completo de app da Web que chama todos os métodos da API Forms
diretamente está disponível no
repositório apps-script-samples do GitHub (em inglês).
Executar o app da Web
Depois de configurar e implantar o projeto como um app da Web, você pode testar algumas operações.
Clique no botão Criar formulário para criar um formulário.
O novo formulário agora está visível no campo ID do formulário. Para abrir, clique em Abrir no Formulários.
Depois de abrir o novo formulário em uma janela separada, adicione algumas perguntas manualmente e clique em Get Form by Id. As novas perguntas vão aparecer na saída JSON à direita.
Confira os outros métodos disponíveis no app e observe a saída à direita de cada operação.
Como trabalhar com observadores do Formulários
Observe também os botões para observadores de formulários. Eles usam o recurso de observação da API Forms e realizam operações para criar, listar, excluir e renovar observações. É necessário configurar um projeto com tópicos do Cloud Pub/Sub para usá-los.
Para mais informações sobre observações da API Forms e o Cloud Pub/Sub, consulte Configurar e receber notificações push.
Próximas etapas
Personalize o app de exemplo de acordo com suas necessidades. Veja alguns exemplos:
- Crie um banco de questões em uma planilha Google e use o serviço SpreadsheetApp do Apps Script para buscar perguntas de uma planilha e preencher novos formulários.
- Outra opção é armazenar o banco de questões em um banco de dados SQL. Assim, você pode usar o serviço JDBC do Apps Script para preencher formulários com perguntas do banco de dados.
- Gerar um teste e salvar as notas em um boletim escolar das Planilhas Google.
- Configure seu projeto com o Cloud Pub/Sub e use o recurso watches para gerar um ranking de estudantes em tempo real e mostrar os resultados do teste.