Élément de question qui permet d'indiquer l'heure de la journée. 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 time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTimeItem();
item.setTitle('What time do you usually wake up in the morning?');
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
createResponse(hour, minute) | ItemResponse | Crée un objet ItemResponse pour cet élément de temps. |
duplicate() | TimeItem | 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. |
getPoints() | Integer | Affiche le barème de notation d'un élément. |
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. |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setGeneralFeedback(feedback) | TimeItem | 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) | TimeItem | 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) | TimeItem | Définit le nombre de points qu'un élément notable vaut. |
setRequired(enabled) | TimeItem | Ce paramètre détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | TimeItem | 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(hour, minute)
Crée un objet ItemResponse pour cet élément de temps. Les arguments hour et minute sont mieux représentés par des entiers compris entre 0 et 23, et entre 0 et 59, respectivement. S'ils dépassent ces limites, ils se comportent comme une horloge. Par exemple, 10, 90 est interprété comme 11:30 et -1, 60 est interprété comme 00:00.
Paramètres
| Nom | Type | Description |
|---|---|---|
hour | Integer | L'heure, représentée par un entier compris entre 0 et 23 |
minute | Integer | La minute de l'heure, représentée par un entier compris entre 0 et 59 |
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
TimeItem : doublon de TimeItem, 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
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
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
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
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
TimeItem : cet élément TimeItem, 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
TimeItem : cet élément TimeItem, 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
TimeItem : cet élément TimeItem, 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
TimeItem : é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
TimeItem : cet élément TimeItem, 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