Questa pagina fornisce una panoramica dell'esempio di app web di Apps Script per l'API Moduli Google.
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 all'API direttamente utilizzando REST.
Poiché Apps Script offre un modo semplice per ottenere sia un token di accesso OAuth valido sia per effettuare chiamate REST, è facile integrare Apps Script direttamente con l'API Moduli. Apps Script fornisce già un servizio Forms 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 come segue:
Ottieni un token di accesso OAuth autenticato e basato su ambito.
ScriptApp.getOAuthToken();Includi il token OAuth nell'argomento options fornito in qualsiasi chiamata REST all'API.
UrlFetchApp.fetch(Url, options);
Consulta Configurare un progetto Apps Script per un esempio pratico. La guida alla configurazione descrive la struttura di base necessaria per chiamare l'API. Tuttavia, per fornire agli utenti finali un accesso intuitivo all'API, 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 su GitHub a scopo dimostrativo.
Eseguire l'app web
Dopo aver configurato il progetto e averlo disegnato 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 alcune domande manualmente, poi fai clic su Recupero modulo tramite ID e vedrai le nuove domande nell'output JSON a destra.
Non esitare a esplorare gli altri metodi disponibili nell'app e a osservare l'output a destra per ogni operazione.
Utilizzare gli orologi Forms
Notare anche i pulsanti per gli orologi dei moduli. Questi comandi utilizzano la funzionalità degli orologi dell'API Forms ed eseguono operazioni di base per creare, elencare, eliminare e rinnovare gli orologi. Per utilizzarli, devi configurare un progetto con argomenti Cloud Pub/Sub.
Per ulteriori informazioni sugli osservatori 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 di domande in un foglio Google, quindi utilizza il servizio Apps Script SpreadsheetApp per recuperare le domande da un foglio e compilare nuovi moduli.
- In alternativa, la banca di domande può trovarsi 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 di valutazione di Fogli Google.
- Configura il tuo progetto con Cloud Pub/Sub e utilizza la funzionalità watch per generare una classifica degli studenti in tempo reale per visualizzare i risultati dei quiz.