Question qui permet à la personne interrogée de choisir une option dans une séquence numérotée de radios
. Les éléments sont accessibles et accessibles depuis un Form
. Lorsqu'ils sont utilisés dans un quiz, ces éléments
sont notées.
// 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 scaling. |
duplicate() | ScaleItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getGeneralFeedback() | QuizFeedback | Renvoie les commentaires qui s'affichent pour les personnes interrogées lorsqu'elles 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'élément. |
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 la balance. |
getPoints() | Integer | Affiche 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 d'élément, représenté par ItemType . |
getUpperBound() | Integer | Récupère la limite supérieure de la balance. |
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 pouvant être notée n'a pas de réponse correcte ou incorrecte (c'est-à-dire une question 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 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 propriété SectionHeaderItem ). |
Documentation détaillée
createResponse(response)
Crée un ItemResponse
pour cet élément de scaling. La fonction renvoie 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 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 correspondant à 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 ScaleItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Renvoie les commentaires qui s'affichent pour les personnes interrogées lorsqu'elles 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 correspondant à 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 correspondant à 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'élément.
Renvois
Integer
: ID de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 correspondant à 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 la balance.
Renvois
Integer
: limite inférieure de la balance
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 pouvant être noté.
Renvois
Integer
: nombre de points qu'une question vaut.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 correspondant à 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 d'é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 correspondant à 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 la balance.
Renvois
Integer
: limite supérieure de la balance
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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
La limite supérieure doit être comprise entre 3
et 10
inclus. Une nouvelle balance utilise par défaut
la limite inférieure de 1
et la limite supérieure de 5
.
La fonction renvoie une exception de script si les valeurs données se trouvent en dehors des limites autorisées. Valeurs décimales sont tronqués à 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 correspondant à 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 pouvant être notée n'a pas de réponse correcte ou incorrecte (c'est-à-dire une question nécessitant une notation manuelle) ;
Paramètres
Nom | Type | Description |
---|---|---|
feedback | QuizFeedback | les nouveaux commentaires |
Renvois
ScaleItem
: ScaleItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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
: ScaleItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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é pour la limite supérieure |
Renvois
ScaleItem
: ScaleItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 pouvant être noté. 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 correspondant à 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 correspondant à 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 propriété 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms