Question permettant à la personne interrogée de cocher une ou plusieurs cases, ainsi qu'un champ "Autre" facultatif. Vous pouvez accéder aux éléments ou en créer depuis une Form
. Lorsqu'ils sont utilisés dans un quiz, ces éléments sont notés automatiquement.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
clearValidation() | CheckboxItem | Supprime toute validation des données pour cet élément de case à cocher. |
createChoice(value) | Choice | Crée un choix. |
createChoice(value, isCorrect) | Choice | Crée un choix. |
createResponse(responses) | ItemResponse | Crée un ItemResponse pour cet élément de case à cocher. |
duplicate() | CheckboxItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getChoices() | Choice[] | Récupère tous les choix pour un élément. |
getFeedbackForCorrect() | QuizFeedback | Renvoie les commentaires qui sont présentés aux personnes interrogées lorsqu'elles répondent correctement à une question. |
getFeedbackForIncorrect() | QuizFeedback | Renvoie les commentaires qui sont présentés aux personnes interrogées lorsqu'elles répondent de manière incorrecte à une question. |
getHelpText() | String | Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems , PageBreakItems et SectionHeaderItems ). |
getId() | Integer | Récupère l'identifiant unique de l'article. |
getIndex() | Integer | Récupère l'index de l'élément parmi tous les éléments du formulaire. |
getPoints() | Integer | Renvoie le barème de notation d'un élément pouvant être noté. |
getTitle() | String | Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem ). |
getType() | ItemType | Récupère le type de l'élément, représenté par ItemType . |
hasOtherOption() | Boolean | Détermine si l'élément comporte une option "autre". |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setChoiceValues(values) | CheckboxItem | Définit les choix pour un élément à partir d'un tableau de chaînes. |
setChoices(choices) | CheckboxItem | Définit un tableau d'options pour un article. |
setFeedbackForCorrect(feedback) | CheckboxItem | Définit les commentaires à présenter aux personnes interrogées lorsqu'elles répondent correctement à une question. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Définit les commentaires à présenter aux personnes interrogées lorsqu'elles répondent de manière incorrecte à une question. |
setHelpText(text) | CheckboxItem | Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems , PageBreakItems et SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Définit le nombre de points attribués à un élément pouvant être noté. |
setRequired(enabled) | CheckboxItem | Détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | CheckboxItem | Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Définit la validation des données pour cet élément de case à cocher. |
showOtherOption(enabled) | CheckboxItem | Détermine si l'élément comporte une option "Autre". |
Documentation détaillée
clearValidation()
Supprime toute validation des données pour cet élément de case à cocher.
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
Crée un choix.
Paramètres
Nom | Type | Description |
---|---|---|
value | String | la valeur du choix, que les personnes interrogées voient comme une étiquette lorsqu'elles consultent le formulaire |
Renvois
Choice
: le nouveau choix
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
Crée un choix.
Paramètres
Nom | Type | Description |
---|---|---|
value | String | la valeur du choix, que les personnes interrogées voient comme une étiquette lorsqu'elles consultent le formulaire |
isCorrect | Boolean | si c'est une bonne réponse |
Renvois
Choice
: le nouveau choix
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Crée un ItemResponse
pour cet élément de case à cocher. L'argument responses
est un tableau String[]
contenant les valeurs à vérifier. La fonction renvoie une exception si une valeur ne correspond pas à un choix valide pour cet élément, sauf si showOtherOption(enabled)
est défini sur true
.
Paramètres
Nom | Type | Description |
---|---|---|
responses | String[] | un tableau de réponses valides pour cet élément à choix multiples |
Renvois
ItemResponse
: réponse à l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Crée une copie de cet élément et l'ajoute à la fin du formulaire.
Renvois
CheckboxItem
: doublon de ce CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
Récupère tous les choix pour un élément.
Renvois
Choice[]
: tableau de choix
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForCorrect()
Renvoie les commentaires qui sont présentés aux personnes interrogées lorsqu'elles répondent correctement à une question.
Renvois
QuizFeedback
: commentaires, le cas échéant.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
Renvoie les commentaires qui sont présentés aux personnes interrogées lorsqu'elles répondent de manière incorrecte à une question.
Renvois
QuizFeedback
: commentaires, le cas échéant.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems
, PageBreakItems
et SectionHeaderItems
).
Renvois
String
: texte d'aide ou description de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Récupère l'identifiant unique de l'article.
Renvois
Integer
: ID de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Récupère l'index de l'élément parmi tous les éléments du formulaire.
Renvois
Integer
: index de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Renvoie le barème de notation d'un élément pouvant être noté.
Renvois
Integer
: nombre de points attribués à une question.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem
).
Renvois
String
: titre ou texte d'en-tête de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Récupère le type de l'élément, représenté par ItemType
.
Renvois
ItemType
: type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasOtherOption()
Détermine si l'élément comporte une option "autre".
Renvois
Boolean
: true
si l'élément dispose d'une option "autre" ; false
dans le cas contraire
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Détermine si la personne interrogée doit répondre à la question.
Renvois
Boolean
: indique si la personne interrogée doit répondre à la question.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
Définit les choix pour un élément à partir d'un tableau de chaînes. Génère une exception si le tableau donné est vide.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Paramètres
Nom | Type | Description |
---|---|---|
values | String[] | Tableau des valeurs des choix que les répondants voient en tant que libellés lorsqu'ils consultent le formulaire |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
Définit un tableau d'options pour un article. La fonction renvoie une exception si le tableau donné est vide ou contient un élément null
.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
Paramètres
Nom | Type | Description |
---|---|---|
choices | Choice[] | un ensemble de choix |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Génère
Error
: si le tableau donné est null
, vide ou contient un élément null
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
Définit les commentaires à présenter aux personnes interrogées lorsqu'elles répondent correctement à une question.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Paramètres
Nom | Type | Description |
---|---|---|
feedback | QuizFeedback | le nouveau feedback. Une valeur nulle effacera les commentaires. |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
Définit les commentaires à présenter aux personnes interrogées lorsqu'elles répondent de manière incorrecte à une question.
Paramètres
Nom | Type | Description |
---|---|---|
feedback | QuizFeedback | les nouveaux commentaires |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems
, PageBreakItems
et SectionHeaderItems
).
Paramètres
Nom | Type | Description |
---|---|---|
text | String | le nouveau texte d'aide |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Définit le nombre de points attribués à un élément pouvant être noté. La valeur par défaut des nouveaux éléments est 0.
Paramètres
Nom | Type | Description |
---|---|---|
points | Integer | le nombre de points d'un élément de la question ; |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Détermine si la personne interrogée doit répondre à la question.
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | si la personne interrogée doit répondre à la question |
Renvois
CheckboxItem
: élément actuel (pour l'enchaînement)
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'une SectionHeaderItem
).
Paramètres
Nom | Type | Description |
---|---|---|
title | String | le nouveau titre ou texte de l'en-tête |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Définit la validation des données pour cet élément de case à cocher. La transmission d'une valeur nulle ou d'une validation sans aucune fonction d'exigence appelée supprime toute validation antérieure.
Paramètres
Nom | Type | Description |
---|---|---|
validation | CheckboxValidation | une case à cocher "CheckboxValidation" pour l'appliquer à cet élément. |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
Détermine si l'élément comporte une option "Autre". La valeur par défaut d'un nouveau CheckboxItem
ou MultipleChoiceItem
est false
.
Paramètres
Nom | Type | Description |
---|---|---|
enabled | Boolean | true si une option "Autre" est disponible pour l'élément ; false dans le cas contraire |
Renvois
CheckboxItem
: cette CheckboxItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms