Cette page présente l'exemple d'application Web Apps Script pour l'API Google Forms.
Prérequis
- activer l'API Forms dans votre projet Google Cloud ;
- Configurez un nouveau projet Apps Script comme décrit dans le fichier README de GitHub pour l'exemple d'application Web.
Présentation
L'API Forms permet à tout client authentifié d'accéder directement à l'API à l'aide de REST.
Étant donné qu'Apps Script permet d'obtenir facilement un jeton d'accès OAuth valide et d'effectuer des appels REST, il est facile d'intégrer Apps Script directement à l'API Forms. Apps Script fournit déjà un service Forms existant, qui permet aux scripts de créer, d'accéder et de modifier des formulaires Google Forms. Toutefois, si vous préférez utiliser l'API Forms directement à partir d'Apps Script, configurez l'accès OAuth comme suit:
Obtenez un jeton d'accès OAuth limité et authentifié.
ScriptApp.getOAuthToken();Incluez le jeton OAuth dans l'argument options fourni dans tous les appels REST à l'API.
UrlFetchApp.fetch(Url, options);
Pour voir un exemple, consultez l'article Configurer un projet Apps Script. Le guide de configuration détaille la plomberie de base nécessaire pour appeler l'API. Toutefois, pour fournir un accès intuitif à l'API aux utilisateurs finaux, vous pouvez également essayer et modifier notre exemple d'application Web.
Exemple d'utilisation de l'application Web
Un exemple complet d'application Web qui appelle directement toutes les méthodes de l'API Forms est disponible sur GitHub à titre de démonstration.
Exécuter l'application Web
Une fois que vous avez configuré votre projet et l'avez déployé en tant qu'application Web, vous pouvez essayer quelques opérations de base.
Créez un formulaire en cliquant sur le bouton Créer un formulaire.
Le nouveau formulaire est maintenant visible dans le champ ID du formulaire:. Vous pouvez l'ouvrir en cliquant sur Ouvrir dans Forms.
Après avoir ouvert le nouveau formulaire dans une fenêtre distincte, ajoutez quelques questions manuellement, puis cliquez sur Get Form by Id (Obtenir le formulaire par ID). Vos nouvelles questions s'afficheront dans la sortie JSON sur la droite.
N'hésitez pas à explorer les autres méthodes disponibles dans l'application et à observer le résultat à droite pour chaque opération.
Utiliser les montres Forms
Vous remarquerez également les boutons des formulaires watches. Ces produits utilisent la fonctionnalité de surveillance de l'API Forms et effectuent des opérations de base pour créer, répertorier, supprimer et renouveler des surveillances. Vous devez configurer un projet avec des sujets Cloud Pub/Sub pour pouvoir les utiliser.
Pour en savoir plus sur les outils de surveillance de l'API Forms et sur Cloud Pub/Sub, consultez la page Configurer et recevoir des notifications push.
Étapes suivantes
Essayez de personnaliser l'application exemple en fonction de vos besoins. Voici quelques exemples :
- Créez une banque de questions dans une feuille de calcul Google Sheets, puis utilisez le service SpreadsheetApp d'Apps Script pour récupérer les questions d'une feuille et les remplir de nouveaux formulaires.
- Votre banque de questions peut également résider dans une base de données SQL dans laquelle vous pouvez utiliser le service JDBC d'Apps Script pour remplir des formulaires avec des questions de la base de données.
- Générez un quiz et enregistrez les scores dans un carnet de notes Google Sheets.
- Configurez votre projet avec Cloud Pub/Sub et utilisez la fonctionnalité montres pour générer un classement des élèves en temps réel afin d'afficher les résultats du questionnaire.