Élément de question qui permet au répondant de choisir une option parmi une séquence numérotée de cases d'option. Les éléments sont accessibles ou peuvent être créés à partir d'un 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. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
create | Item | Crée un Item pour cet élément d'échelle. |
duplicate() | Scale | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
get | Quiz | Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée. |
get | String | Obtient le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que Image, Page et Section). |
get | Integer | Obtient l'identifiant unique de l'élément. |
get | Integer | Obtient l'index de l'élément parmi tous les éléments du formulaire. |
get | String | Obtient le libellé de la limite inférieure de l'échelle, le cas échéant. |
get | Integer | Obtient la limite inférieure de l'échelle. |
get | Integer | Renvoie la valeur en points d'un élément pouvant être noté. |
get | String | Obtient le libellé de la limite supérieure de l'échelle, le cas échéant. |
get | String | Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un Section). |
get | Item | Obtient le type de l'élément, représenté sous la forme d'un Item. |
get | Integer | Récupère la limite supérieure de l'échelle. |
is | Boolean | Détermine si la personne interrogée doit répondre à la question. |
set | Scale | Définit les limites inférieure et supérieure de l'échelle. |
set | Scale | Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle). |
set | Scale | 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 Image, Page et Section). |
set | Scale | Définit les libellés des limites inférieure et supérieure de l'échelle. |
set | Scale | Définit le nombre de points qu'un devoir peut rapporter. |
set | Scale | Indique si la personne interrogée doit répondre à la question. |
set | Scale | Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un Section). |
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 est 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 de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 : un double de ce ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée.
Renvois
QuizFeedback|null : commentaire, le cas échéant.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Obtient 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Obtient l'identifiant unique de l'élément.
Renvois
Integer : ID de l'article
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Obtient 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getLeftLabel()
Obtient le libellé 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getLowerBound()
Obtient 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Renvoie la valeur en points 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getRightLabel()
Obtient le libellé 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Obtient le type de l'élément, représenté sous la forme d'un ItemType.
Renvois
ItemType : type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 avec un ou plusieurs des scopes 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 le répondant doit répondre à la question.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 a une limite inférieure de 1 et une limite supérieure de 5.
Génère une exception de script si les valeurs fournies sont 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 : 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 scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle).
Paramètres
| Nom | Type | Description |
|---|---|---|
feedback | Quiz | les nouveaux commentaires |
Renvois
ScaleItem : ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 : ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 | nouvelle étiquette pour la limite inférieure |
upper | String | nouveau libellé pour la limite supérieure |
Renvois
ScaleItem : ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Définit le nombre de points qu'un devoir peut rapporter. La valeur par défaut pour les nouveaux éléments est 0.
Paramètres
| Nom | Type | Description |
|---|---|---|
points | Integer | le nombre de points qu'un élément de question vaut ; |
Renvois
ScaleItem : ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Indique 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'association en chaîne)
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 SectionHeaderItem).
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | le nouveau titre ou texte d'en-tête. |
Renvois
ScaleItem : ScaleItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms