Esta página apresenta 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 app da Web de exemplo.
Visão geral
A API Forms permite que qualquer cliente autenticado acesse a API diretamente usando o REST.
Como o Apps Script oferece uma maneira fácil de receber um token de acesso OAuth válido e fazer chamadas REST, é simples integrar o Apps Script diretamente à API Forms. O Apps Script já oferece um serviço de formulários, que permite que os scripts criem, acessem e modifiquem os Formulários Google. No entanto, se você preferir usar a API Forms diretamente no 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 OAuth no argumento options fornecido em todas as chamadas REST para a API.
UrlFetchApp.fetch(Url, options);
Consulte Configurar um projeto do Apps Script para um exemplo disso em ação. O guia de configuração detalha a estrutura básica necessária para chamar a API. No entanto, para fornecer acesso intuitivo à API para os usuários finais, você também pode testar e modificar nosso app da Web de exemplo.
Exemplo de uso do app da Web
Um exemplo completo de app da Web que chama todos os métodos da API Forms diretamente está disponível no GitHub para fins de demonstração.
Como executar o app da Web
Depois de configurar seu projeto e implantá-lo como um app da Web, tente algumas operações básicas.
Clique no botão Criar formulário para criar um novo formulário.
O novo formulário agora aparece no campo Form id e pode ser aberto clicando em Abrir no Forms.
Depois de abrir o novo formulário em uma janela separada, tente adicionar algumas perguntas manualmente. Em seguida, clique em Get Form by Id (Receber formulário por ID). As novas perguntas vão aparecer na saída JSON à direita.
Sinta-se à vontade para conferir os outros métodos disponíveis no app e observar a saída à direita de cada operação.
Como trabalhar com os relógios do app Formulários
Observe também os botões para monitoramento de formulários. Eles usam o recurso de monitoramento da API Forms e executam operações básicas para criar, listar, excluir e renovar monitoramentos. É necessário configurar um projeto com tópicos do Cloud Pub/Sub para usá-los.
Para mais informações sobre os relógios da API Forms e o Cloud Pub/Sub, consulte Configurar e receber notificações push.
Próximas etapas
Tente personalizar o app de exemplo para atender às suas necessidades. Veja alguns exemplos:
- Crie um banco de perguntas em uma planilha Google e use o serviço SpreadsheetApp do Apps Script para buscar perguntas de uma planilha e preencher novos formulários.
- Como alternativa, o banco de perguntas pode estar em um banco de dados SQL, em que 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 livro de registro de notas do Google Planilhas.
- Configure seu projeto com o Cloud Pub/Sub e use o recurso watches para gerar um ranking de estudantes em tempo real para mostrar os resultados do teste.