L'administration de questionnaires est l'une des fonctionnalités clés de Google Forms. Ce guide vous explique comment créer un questionnaire et ajouter des options de notation avec l'API Forms.
Créer un quiz de base
La première étape de la création d'un quiz se déroule en deux étapes: vous créez un formulaire, puis vous modifiez ses paramètres pour le définir comme un quiz. Pour obtenir des instructions de base sur la configuration, consultez Créer un formulaire ou un questionnaire.
Ajouter des questions
Une fois le quiz créé, ajoutez les questions (consultez Question object pour obtenir la liste des types de questions). Vous pouvez inclure des options de notation lorsque vous ajoutez les questions pour la première fois ou les mettre à jour ultérieurement. Voici un exemple de code JSON pour un nouvel élément de question incluant des options de notation:
"item": {
"title": "Which of these singers was not a member of Destiny's Child?",
"questionItem": {
"question": {
"required": True,
"grading": {
"pointValue": 2,
"correctAnswers": {
"answers": [{"value": "Rihanna"}]
},
"whenRight": {"text": "You got it!"},
"whenWrong": {"text": "Sorry, that's wrong"}
},
"choiceQuestion": {
"type": "RADIO",
"options": [
{"value": "Kelly Rowland"},
{"value": "Beyoncé"},
{"value": "Rihanna"},
{"value": "Michelle Williams"}
]
}
}
}
}
Consultez Mettre à jour un formulaire ou un questionnaire pour découvrir comment ajouter un élément de question à un formulaire.
Ajouter des options de notation
Ajouter des options de notation aux questions de quiz permet d'automatiser le processus de notation. Chaque question peut avoir un barème de notation attribué et fournir des commentaires à l'utilisateur sur sa réponse.
Pour les types de questions ci-dessous, ajouter un champ correctAnswers permet de les noter automatiquement lorsque le quiz est envoyé. Vous pouvez fournir des commentaires spécifiques pour les réponses correctes et incorrectes à l'aide des champs whenRight et whenWrong.
- Case à cocher
- Radio
- Menu déroulant
Les questions à réponse courte peuvent également être notées automatiquement en ajoutant un champ correctAnswers. Toutefois, vous ne pouvez fournir que des commentaires generalFeedback, et non whenRight ni whenWrong. Pour les autres types de questions, la notation n'est pas automatique et vous ne pouvez fournir que generalFeedback.
Remarque:À l'exception des questions pour lesquelles la réponse est fournie via l'importation d'un fichier, la réponse de l'utilisateur est capturée et évaluée sous forme de texte (voir l'objet TextAnswer pour en savoir plus sur la mise en forme des différents types de réponses). Pour être correcte, la réponse doit correspondre exactement à la clé de réponse.