Exemple d'application Web Apps Script

Cette page présente un 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 de 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 un jeton d'accès OAuth valide et d'effectuer des appels REST, il est possible 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. Toutefois, si vous préférez utiliser l'API Forms directement depuis Apps Script, configurez l'accès OAuth comme suit :

  1. Obtenez un jeton d'accès OAuth authentifié et limité à un champ d'application.

    ScriptApp.getOAuthToken();

  2. Incluez le jeton OAuth dans l'argument options fourni dans tous les appels REST à l'API.

    UrlFetchApp.fetch(Url, options);

Pour voir un exemple de cette procédure, consultez Configurer un projet Apps Script. Le guide de configuration décrit en détail l'infrastructure nécessaire pour appeler l'API. Toutefois, pour fournir aux utilisateurs un accès intuitif à l'API, 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 dans le dépôt GitHub apps-script-samples.

Exécuter l'application Web

Une fois que vous avez configuré votre projet et que vous l'avez déployé en tant qu'application Web, vous pouvez essayer certaines opérations.

  1. 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.

  2. 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). Vous verrez vos nouvelles questions dans la sortie JSON à droite.

Explorez les autres méthodes disponibles dans l'application et observez le résultat à droite pour chaque opération.

Utiliser les montres Forms

Notez également les boutons pour les formulaires watches. Ils utilisent la fonctionnalité d'observation de l'API Forms et effectuent des opérations pour créer, lister, supprimer et renouveler des observations. Pour utiliser les sujets Cloud Pub/Sub, vous devez configurer un projet avec ces sujets.

Pour en savoir plus sur les montres de l'API Forms et Cloud Pub/Sub, consultez 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 Apps Script SpreadsheetApp pour récupérer les questions d'une feuille et remplir de nouveaux formulaires.
  • Vous pouvez également stocker votre banque de questions dans une base de données SQL. Vous pourrez alors utiliser le service JDBC d'Apps Script pour remplir les formulaires avec les questions de la base de données.
  • Générez un quiz et enregistrez les notes dans un carnet de notes Google Sheets.
  • Configurez votre projet avec Cloud Pub/Sub et utilisez la fonctionnalité watches pour générer un classement des élèves en temps réel et afficher les résultats des quiz.