Un élément de question qui permet à la personne interrogée d'indiquer une date et une heure. 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 date-time item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateTimeItem(); item.setTitle('When do you want to meet?');
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
createResponse(response) | ItemResponse | Crée un ItemResponse pour cet élément de date/heure. |
duplicate() | DateTimeItem | 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 . |
includesYear() | Boolean | Détermine si l'élément de date inclut une option d'année. |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setGeneralFeedback(feedback) | DateTimeItem | 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) | DateTimeItem | 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 ). |
setIncludesYear(enableYear) | DateTimeItem | Détermine si l'élément de date inclut un paramètre d'année. |
setPoints(points) | DateTimeItem | Définit le nombre de points qu'un élément pouvant être noté. |
setRequired(enabled) | DateTimeItem | Détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | DateTimeItem | 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 date et d'heure. Le champ des secondes de l'objet Date
est ignoré. par défaut, les champs année, mois, jour, heure et minutes sont utilisés. Si
setIncludesYear(enabled)
est définie sur false
, l'année est
sont ignorées.
Paramètres
Nom | Type | Description |
---|---|---|
response | Date | Un objet Date qui représente un mois, un jour, une heure, une minute et éventuellement
an |
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
DateTimeItem
: doublon de DateTimeItem
, 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
includesYear()
Détermine si l'élément de date inclut une option d'année.
Renvois
Boolean
: true
si la date inclut le paramètre d'année false
si ce n'est pas le cas
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
DateTimeItem
: DateTimeItem
, 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
DateTimeItem
: DateTimeItem
, 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
setIncludesYear(enableYear)
Détermine si l'élément de date inclut un paramètre d'année. La valeur par défaut pour les nouveaux éléments de date est true
.
Paramètres
Nom | Type | Description |
---|---|---|
enableYear | Boolean | true si la date inclut le paramètre d'année ; false si ce n'est pas le cas |
Renvois
DateTimeItem
: DateTimeItem
, 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
DateTimeItem
: DateTimeItem
, 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
DateTimeItem
: é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
DateTimeItem
: DateTimeItem
, 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