Un élément de question qui permet à la personne interrogée d'indiquer une durée. Les éléments sont accessibles ou
créé à 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 duration item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
createResponse(hours, minutes, seconds) | ItemResponse | Crée un ItemResponse pour cet élément de date. |
duplicate() | DurationItem | 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. |
getPoints() | Integer | Affiche 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 d'élément, représenté par ItemType. |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setGeneralFeedback(feedback) | DurationItem | 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) | DurationItem | 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) | DurationItem | Définit le nombre de points qu'un élément pouvant être noté. |
setRequired(enabled) | DurationItem | Détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | DurationItem | 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(hours, minutes, seconds)
Crée un ItemResponse pour cet élément de date. Il est préférable de représenter les arguments hours, minutes et seconds sous forme d'entiers compris entre 0 et 72 pour
hours et 0 à 59 pour minutes et seconds. Les valeurs
dépassent ces limites sont limitées: par exemple, 24, 60, 90 est interprété comme 24:59:59.
Paramètres
| Nom | Type | Description |
|---|---|---|
hours | Integer | Heures, représentées sous la forme d'un entier compris entre 0 et 72 |
minutes | Integer | les minutes, représentées par un entier compris entre 0 et 59. |
seconds | Integer | Secondes, représentées par un entier compris entre 0 et 59 |
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
DurationItem : doublon de DurationItem, 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
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
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
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
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
DurationItem : DurationItem, 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
DurationItem : DurationItem, 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
DurationItem : DurationItem, 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
DurationItem : é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
DurationItem : DurationItem, 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