Nesta página, você terá uma visão geral do exemplo do 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
Com a API Forms, qualquer cliente autenticado pode acessar a API diretamente usando REST.
Como o Apps Script fornece uma maneira fácil de receber um token de acesso OAuth válido e fazer chamadas REST, é simples integrar o Apps Script diretamente com a API Forms. O Apps Script já oferece um serviço do 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 do Apps Script, configure o acesso do OAuth da seguinte maneira:
Receba um token de acesso OAuth com escopo e autenticado.
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 ver um exemplo disso na prática. O guia de configuração detalha o encanamento básico necessário 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 de app da Web
Um exemplo completo de app da Web que chama diretamente todos os métodos da API Forms está disponível no GitHub (link em inglês) para fins de demonstração.
Como executar o app da Web
Depois de configurar o projeto e implantá-lo como um app da Web, é possível testar algumas operações básicas.
Crie um novo formulário clicando no botão Create Form.
O novo formulário agora está visível no campo Form ID: e você pode abri-lo clicando em Abrir no Formulários.
Depois de abrir o novo formulário em uma janela separada, tente adicionar algumas perguntas manualmente e clique em Get Form by Id. As novas perguntas serão exibidas na saída JSON à direita.
Fique à vontade para explorar os outros métodos disponíveis no app e observar a saída à direita para cada operação.
Trabalhar com relógios do Formulários
Observe também os botões para relógios de formulários. Eles usam o recurso de monitoramentos da API Forms e executam operações básicas para criar, listar, excluir e renovar relógios. Você precisa configurar um projeto com tópicos do Cloud Pub/Sub para usá-los.
Para mais informações sobre relógios da API Forms e o Cloud Pub/Sub, consulte Configurar e receber notificações push.
Próximas etapas
Personalize o app de exemplo para atender às suas necessidades. Veja alguns exemplos:
- Criar uma central de perguntas em uma planilha Google e usar o serviço SpreadsheetApp do Apps Script para buscar perguntas em uma página e preencher novos formulários.
- Como alternativa, seu banco de perguntas pode ficar em um banco de dados SQL, em que é possível usar o Serviço JDBC do Apps Script para preencher formulários com perguntas do banco de dados.
- Gere um teste e salve as pontuações em um diário de classe do Planilhas Google.
- Configure seu projeto com o Cloud Pub/Sub e use o recurso relógios para gerar um quadro de liderança dos alunos em tempo real e exibir os resultados do teste.