Cette page présente l'exemple d'application Web Apps Script pour l'API Google Forms.
Prérequis
- Activez l'API Forms dans votre projet Google Cloud.
- Configurez un projet Apps Script comme décrit dans le fichier README GitHub pour l'exemple d'application Web.
Présentation
L'API Forms permet à tout client authentifié d'accéder à l'API directement à 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, qui permet aux scripts de créer, d'accéder et de modifier des formulaires Google. Toutefois, si vous préférez utiliser l'API Forms directement depuis Apps Script, configurez l'accès OAuth comme suit:
Obtenez un jeton d'accès OAuth authentifié et limité.
ScriptApp.getOAuthToken();Incluez le jeton OAuth dans l'argument options fourni dans tous les appels REST à l'API.
UrlFetchApp.fetch(Url, options);
Pour en savoir plus, consultez Configurer un projet Apps Script. Le guide de configuration détaille la tuyauterie de base nécessaire pour appeler l'API. Toutefois, pour fournir un accès intuitif à l'API pour les utilisateurs finaux, vous pouvez également tester et modifier notre exemple d'application Web.
Exemple d'utilisation d'une application Web
Un exemple d'application Web complète qui appelle directement toutes les méthodes de l'API Forms est disponible sur GitHub à des fins 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 désormais 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, essayez d'ajouter quelques questions manuellement, puis cliquez sur Get Form by Id (Obtenir le formulaire par ID). Vos nouvelles questions s'afficheront dans la sortie JSON à droite.
N'hésitez pas à explorer les autres méthodes disponibles dans l'application et à observer la sortie à droite pour chaque opération.
Utiliser des montres Forms
Notez également les boutons des montres de formulaires. Ils utilisent la fonctionnalité de surveillance de l'API Forms et effectuent des opérations de base pour créer, lister, supprimer et renouveler des surveillances. Pour les utiliser, vous devez configurer un projet avec des sujets Cloud Pub/Sub.
Pour en savoir plus sur les veilles de l'API Forms et 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, puis utilisez le service Apps Script SpreadsheetApp pour extraire des questions d'une feuille afin de renseigner de nouveaux formulaires.
- Vous pouvez également stocker votre banque de questions dans une base de données SQL, où vous pouvez utiliser le service JDBC Apps Script pour renseigner des formulaires avec des questions issues de la base de données.
- Générez un questionnaire et enregistrez les notes dans un cahier de notes Google Sheets.
- Configurez votre projet avec Cloud Pub/Sub et utilisez la fonctionnalité watches (Montres) pour générer un classement des élèves en temps réel afin d'afficher les résultats des quiz.