Questa pagina fornisce una panoramica dell'esempio di app web Apps Script per l'API Google Forms.
Prerequisiti
- Abilita l'API Forms nel tuo progetto Google Cloud.
- Configura un nuovo progetto Apps Script come descritto nel file README di GitHub per l'app web di esempio.
Panoramica
L'API Forms consente a qualsiasi client autenticato di accedere direttamente all'API utilizzando REST.
Poiché Apps Script fornisce un modo per ottenere sia un token di accesso OAuth valido sia per effettuare chiamate REST, è possibile integrare Apps Script direttamente con l'API Forms. Apps Script fornisce già un servizio Moduli esistente, che consente agli script di creare, accedere e modificare i moduli. Tuttavia, se preferisci utilizzare l'API Forms direttamente da Apps Script, configura l'accesso OAuth nel seguente modo:
Ottieni un token di accesso OAuth autenticato e con ambito.
ScriptApp.getOAuthToken();Includi il token OAuth nell'argomento options fornito in qualsiasi chiamata REST all'API.
UrlFetchApp.fetch(Url, options);
Per un esempio pratico, consulta Configurare un progetto Apps Script. La guida alla configurazione descrive in dettaglio l'infrastruttura necessaria per chiamare l'API. Tuttavia, per fornire un accesso intuitivo all'API per gli utenti, puoi anche provare e modificare la nostra app web di esempio.
Esempio di utilizzo dell'app web
Un'app web di esempio completa che chiama direttamente tutti i metodi dell'API Forms è disponibile nel repository GitHub apps-script-samples.
Esecuzione dell'app web
Dopo aver configurato il progetto ed eseguito il deployment come app web, puoi provare alcune operazioni.
Crea un nuovo modulo facendo clic sul pulsante Crea modulo.
Il nuovo modulo è ora visibile nel campo ID modulo e puoi aprirlo facendo clic su Apri in Moduli.
Dopo aver aperto il nuovo modulo in una finestra separata, prova ad aggiungere alcune domande manualmente, poi fai clic su Ottieni modulo per ID e vedrai le nuove domande nell'output JSON a destra.
Esplora gli altri metodi disponibili nell'app e osserva l'output a destra per ogni operazione.
Utilizzo dei quadranti di Forme
Nota anche i pulsanti per i moduli degli smartwatch. Questi utilizzano la funzionalità di monitoraggio dell'API Forms ed eseguono operazioni per creare, elencare, eliminare e rinnovare i monitoraggi. Per utilizzarli, devi configurare un progetto con argomenti Cloud Pub/Sub.
Per saperne di più sulle API Forms e su Cloud Pub/Sub, consulta Configurare e ricevere notifiche push.
Passaggi successivi
Prova a personalizzare l'app di esempio in base alle tue esigenze. Ecco alcuni esempi:
- Crea una banca di domande in un foglio Google e poi utilizza il servizio Apps Script SpreadsheetApp per recuperare le domande da un foglio e compilare nuovi moduli.
- In alternativa, la banca di domande può risiedere in un database SQL in cui puoi utilizzare il servizio JDBC di Apps Script per compilare i moduli con le domande del database.
- Genera un quiz e salva i punteggi in un registro elettronico di Fogli Google.
- Configura il tuo progetto con Cloud Pub/Sub e utilizza la funzionalità orologi per generare una classifica degli studenti in tempo reale per visualizzare i risultati dei quiz.