Comparer l'API REST avec le service Forms

Il existe un certain chevauchement entre ce que vous pouvez faire avec l'API Google Forms et le service Forms sur Apps Script. Ce guide décrit les similitudes et les différences entre les deux pour vous aider à choisir celle qui convient le mieux à votre projet.

Fonctionnalités Forms compatibles

L'API REST et le service Forms sur Apps Script sont compatibles avec des fonctionnalités Forms qui ne le sont pas dans l'autre. La liste exacte des fonctionnalités compatibles change au fil du temps. Vous pouvez explorer le reste de la documentation pour savoir si une fonctionnalité spécifique est prise en charge.

L'API REST n'est pas compatible avec les éléments suivants :

  • Envoyer des réponses à un formulaire
  • Inclure des données détaillées sur les formulaires ou les réponses dans le corps des notifications Pub/Sub

Le service Forms sur Apps Script n'est pas compatible avec les éléments suivants :

  • S'abonner aux événements de formulaire avec Cloud Pub/Sub
  • Définir les bonnes réponses pour les types de questions autres que les questions à choix multiples

Demander une nouvelle fonctionnalité de l'API REST

L'API REST est plus récente que le service Forms sur Apps Script, et de nouvelles fonctionnalités sont ajoutées régulièrement. Envoyez une demande de fonctionnalité si vous souhaitez qu'une fonctionnalité spécifique soit traitée en priorité.

Comportement basé sur les événements

Les déclencheurs {apps_script_name_short} et la ressource forms.watches de l'API REST permettent d'effectuer une action lorsqu'un formulaire est modifié.

Privilégiez forms.watches de l'API REST pour :

  • Fiabilité maximale
  • Interopérabilité avec Cloud Pub/Sub
  • Notifications lorsque des formulaires sont modifiés

Préférez les déclencheurs Apps Script pour :

  • Données de formulaire ou de réponse incluses dans chaque notification
  • Déclencheurs temporels

Quotas

Apps Script et l'API Forms ont des limites de service différentes.

Langues et environnements

Si vous préférez développer en JavaScript, Apps Script peut vous faire gagner du temps en automatisant la configuration d'un projet de console Google Cloud et d'un flux de consentement OAuth. Apps Script fournit également un éditeur de code basé sur un navigateur et exécute votre code sur les serveurs Google.

En revanche, l'API REST fournit des bibliothèques clientes dans de nombreux langages autres que JavaScript, ce qui vous permet de développer dans le langage de votre choix et de ne pas être soumis à des limites d'exécution ou d'exécutions simultanées.

Utiliser l'API REST depuis Apps Script

Si vous préférez l'environnement de développement Apps Script, mais que vous souhaitez utiliser les fonctionnalités de l'API REST Forms, vous pouvez le faire à l'aide de UrlFetchApp. Pour en savoir plus, consultez Configurer un projet Apps Script.

L'API REST Forms n'est pas encore disponible en tant que service avancé Apps Script. Envoyez une demande de fonctionnalité si vous souhaitez qu'il soit compatible.

Étapes suivantes