Élément de question qui permet à la personne interrogée de choisir une option parmi une séquence numérotée de cases d'option. Vous pouvez accéder aux éléments ou les créer depuis un Form. Lorsqu'ils sont utilisés dans un questionnaire, ces éléments sont notés.
// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
.setBounds(1, 10);
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
createResponse(response) | ItemResponse | Crée un ItemResponse pour cet élément de l'échelle. |
duplicate() | ScaleItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getGeneralFeedback() | QuizFeedback | Affiche les commentaires que voient les personnes interrogées lorsqu'elles répondent à une question notable. |
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. |
getLeftLabel() | String | Récupère le libellé de la limite inférieure, le cas échéant. |
getLowerBound() | Integer | Récupère la limite inférieure de l'échelle. |
getPoints() | Integer | Affiche le barème de notation d'un élément. |
getRightLabel() | String | Récupère le libellé de la limite supérieure de l'échelle, le cas échéant. |
getTitle() | String | Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem). |
getType() | ItemType | Récupère le type de l'élément, représenté par ItemType. |
getUpperBound() | Integer | Récupère la limite supérieure de l'échelle. |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setBounds(lower, upper) | ScaleItem | Définit les limites inférieure et supérieure de l'échelle. |
setGeneralFeedback(feedback) | ScaleItem | Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (par exemple, en cas de questions nécessitant une notation manuelle). |
setHelpText(text) | ScaleItem | 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). |
setLabels(lower, upper) | ScaleItem | Définit des étiquettes pour les limites inférieure et supérieure de l'échelle. |
setPoints(points) | ScaleItem | Définit le nombre de points qu'un élément notable vaut. |
setRequired(enabled) | ScaleItem | Ce paramètre détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | ScaleItem | Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem). |
Documentation détaillée
createResponse(response)
Crée un ItemResponse pour cet élément de l'échelle. Lève une exception si l'argument response se situe en dehors des limites définies pour l'élément.
Paramètres
| Nom | Type | Description |
|---|---|---|
response | Integer | une valeur pour cet élément de l'échelle |
Aller-retour
ItemResponse : réponse de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
Aller-retour
ScaleItem : doublon de ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Affiche les commentaires que voient les personnes interrogées lorsqu'elles répondent à une question notable.
Aller-retour
QuizFeedback : commentaires, le cas échéant.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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).
Aller-retour
String : texte d'aide ou description
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
Aller-retour
Integer : ID de l'article
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
Aller-retour
Integer : index de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getLeftLabel()
Récupère le libellé de la limite inférieure, le cas échéant.
Aller-retour
String : libellé de la limite inférieure
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getLowerBound()
Récupère la limite inférieure de l'échelle.
Aller-retour
Integer : limite inférieure de l'échelle
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Affiche le barème de notation d'un élément.
Aller-retour
Integer : nombre de points gagnés par une question.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getRightLabel()
Récupère le libellé de la limite supérieure de l'échelle, le cas échéant.
Aller-retour
String : libellé de la limite supérieure de l'échelle
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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'un élément SectionHeaderItem).
Aller-retour
String : titre ou texte de l'en-tête de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
Aller-retour
ItemType : type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getUpperBound()
Récupère la limite supérieure de l'échelle.
Aller-retour
Integer : limite supérieure de l'échelle
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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.
Aller-retour
Boolean : indique si la personne interrogée doit répondre à la question.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setBounds(lower, upper)
Définit les limites inférieure et supérieure de l'échelle. La limite inférieure doit être 0 ou 1. La limite supérieure doit être comprise entre 3 et 10 inclus. Une nouvelle échelle prend par défaut une limite inférieure de 1 et une limite supérieure de 5.
Lève une exception de script si les valeurs données dépassent les limites autorisées. Les nombres décimaux sont tronqués au nombre entier précédent.
Paramètres
| Nom | Type | Description |
|---|---|---|
lower | Integer | la nouvelle limite inférieure |
upper | Integer | la nouvelle limite supérieure |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Génère
Error : si la limite inférieure ou supérieure n'est pas valide
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (par exemple, en cas de questions nécessitant une notation manuelle).
Paramètres
| Nom | Type | Description |
|---|---|---|
feedback | QuizFeedback | les nouveaux commentaires |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setLabels(lower, upper)
Définit des étiquettes pour les limites inférieure et supérieure de l'échelle.
Paramètres
| Nom | Type | Description |
|---|---|---|
lower | String | le nouveau libellé de la limite inférieure |
upper | String | le nouveau libellé de la limite supérieure |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 qu'un élément notable vaut. La valeur par défaut pour les nouveaux éléments est 0.
Paramètres
| Nom | Type | Description |
|---|---|---|
points | Integer | le nombre de points d'une question |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Ce paramètre 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 |
Aller-retour
ScaleItem : élément actuel (pour les chaînages)
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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'un élément SectionHeaderItem).
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | le nouveau titre ou texte de l'en-tête |
Aller-retour
ScaleItem : cet élément ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms