Questa pagina fornisce una panoramica dell'esempio di app web Apps Script per l'API Google Forms.
Prerequisiti
- Abilitare 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 tramite REST.
Poiché Apps Script offre un modo semplice per ottenere un token di accesso OAuth valido ed effettuare chiamate REST, è facile integrare Apps Script direttamente con l'API Forms. Apps Script fornisce già un Servizio per i moduli esistente, che consente agli script di creare, accedere e modificare Moduli Google. Tuttavia, se preferisci utilizzare l'API Forms direttamente da Apps Script, configura l'accesso OAuth nel seguente modo:
Ottenere un token di accesso OAuth con ambito e autenticato.
ScriptApp.getOAuthToken();Includi il token OAuth nell'argomento options fornito in qualsiasi chiamata REST all'API.
UrlFetchApp.fetch(Url, options);
Per un esempio pratico, vedi Configurare un progetto Apps Script. La guida alla configurazione descrive in dettaglio gli impianti idraulici di base necessari per chiamare l'API. Tuttavia, per fornire un accesso intuitivo all'API agli utenti finali, puoi anche provare e modificare la nostra app web di esempio.
Esempio di utilizzo dell'app web
A scopo dimostrativo, su GitHub è disponibile un'app web di esempio completa che chiama direttamente tutti i metodi dell'API Forms.
Esecuzione dell'app web
Dopo aver configurato il progetto e averne eseguito il deployment come app web, puoi provare alcune operazioni di base.
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 manualmente alcune domande, poi fai clic su Ottieni modulo tramite ID. Le nuove domande verranno visualizzate nell'output JSON sulla destra.
Esplora gli altri metodi disponibili nell'app e osserva l'output sulla destra per ogni operazione.
Lavorare con gli smartwatch Moduli
Nota anche i pulsanti per i moduli orologi. Questi utilizzano la funzionalità smartwatch dell'API Forms ed eseguono operazioni di base per creare, elencare, eliminare e rinnovare gli smartwatch. Per utilizzarli, devi configurare un progetto con argomenti Cloud Pub/Sub.
Per maggiori informazioni sugli smartwatch dell'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 dati di domande in un foglio Google, quindi utilizza il servizio SpreadsheetApp di Apps Script 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 domande del database.
- Generare un quiz e salvare i punteggi in un registro di Fogli Google.
- Configura il tuo progetto con Cloud Pub/Sub e utilizza la funzionalità degli orologi per generare una classifica in tempo reale degli studenti per mostrare i risultati del quiz.