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 en créer depuis une Form. Lorsqu'ils sont utilisés dans un quiz, 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 d'échelle. |
duplicate() | ScaleItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getGeneralFeedback() | QuizFeedback | Renvoie le feedback qui est présenté aux répondants lorsqu'ils répondent à une question pouvant être notée. |
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 l'étiquette de la limite inférieure de l'échelle, le cas échéant. |
getLowerBound() | Integer | Récupère la limite inférieure de l'échelle. |
getPoints() | Integer | Renvoie le barème de notation d'un élément pouvant être noté. |
getRightLabel() | String | Récupère l'étiquette 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'une 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 à présenter aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les 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 les libellés des limites inférieure et supérieure de l'échelle. |
setPoints(points) | ScaleItem | Définit le nombre de points attribués à un élément pouvant être noté. |
setRequired(enabled) | ScaleItem | 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'une SectionHeaderItem). |
Documentation détaillée
createResponse(response)
Crée un ItemResponse pour cet élément d'échelle. Génère une exception si l'argument response se trouve en dehors des limites définies pour l'élément.
Paramètres
| Nom | Type | Description |
|---|---|---|
response | Integer | une réponse de valeur pour cet élément d'échelle |
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
ScaleItem : doublon de ce ScaleItem, 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
getGeneralFeedback()
Renvoie le feedback qui est présenté aux répondants lorsqu'ils répondent à une question pouvant être notée.
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
getLeftLabel()
Récupère l'étiquette de la limite inférieure de l'échelle, le cas échéant.
Renvois
String : libellé de la limite inférieure de l'échelle.
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
getLowerBound()
Récupère la limite inférieure de l'échelle.
Renvois
Integer : limite inférieure de l'échelle
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
getRightLabel()
Récupère l'étiquette de la limite supérieure de l'échelle, le cas échéant.
Renvois
String : libellé de la limite supérieure de l'échelle
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
getUpperBound()
Récupère la limite supérieure de l'échelle.
Renvois
Integer : limite supérieure de l'échelle
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
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. Par défaut, une nouvelle échelle est définie avec une limite inférieure de 1 et une limite supérieure de 5.
Génère une exception de script si les valeurs données se situent en dehors des limites autorisées. Les décimales sont tronquées à l'entier précédent.
Paramètres
| Nom | Type | Description |
|---|---|---|
lower | Integer | la nouvelle limite inférieure |
upper | Integer | la nouvelle limite supérieure |
Renvois
ScaleItem : cette 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 associée à 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 à présenter aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions nécessitant une notation manuelle).
Paramètres
| Nom | Type | Description |
|---|---|---|
feedback | QuizFeedback | les nouveaux commentaires |
Renvois
ScaleItem : cette ScaleItem, 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
ScaleItem : cette ScaleItem, 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
setLabels(lower, upper)
Définit les libellés des 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 |
Renvois
ScaleItem : cette ScaleItem, 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
ScaleItem : cette ScaleItem, 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
ScaleItem : é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
ScaleItem : cette ScaleItem, 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