Élément de question, présenté sous forme de grille de colonnes et de lignes, qui permet à la personne interrogée de sélectionner un choix par ligne parmi une séquence de cases d'option. Vous pouvez accéder aux éléments ou les créer depuis un Form
.
// Open a form by ID and add a new grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addGridItem(); item.setTitle('Rate your interests') .setRows(['Cars', 'Computers', 'Celebrities']) .setColumns(['Boring', 'So-so', 'Interesting']);
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
clearValidation() | GridItem | Supprime la validation des données pour cet élément de la grille. |
createResponse(responses) | ItemResponse | Crée un ItemResponse pour cet élément de grille. |
duplicate() | GridItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getColumns() | String[] | Récupère les valeurs de chaque colonne de la grille. |
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. |
getRows() | String[] | Récupère les valeurs de chaque ligne de la grille. |
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. |
setColumns(columns) | GridItem | Définit les colonnes de la grille en fonction d'un tableau de valeurs. |
setHelpText(text) | GridItem | 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 ). |
setRequired(enabled) | GridItem | Ce paramètre détermine si la personne interrogée doit répondre à la question. |
setRows(rows) | GridItem | Définit les lignes de la grille en fonction d'un tableau de valeurs. |
setTitle(title) | GridItem | Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem ). |
setValidation(validation) | GridItem | Définit la validation des données pour cet élément de la grille. |
Documentation détaillée
clearValidation()
Supprime la validation des données pour cet élément de la grille.
Aller-retour
GridItem
: cet élément, 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
createResponse(responses)
Crée un ItemResponse
pour cet élément de grille. L'argument responses
doit être un tableau String[]
contenant autant de valeurs que de lignes de la grille. Un élément null
pour une question de grille non requise indique qu'il n'y a aucune réponse à cette ligne. Lève une exception si l'une des valeurs ne correspond pas à un choix valide.
Paramètres
Nom | Type | Description |
---|---|---|
responses | String[] | Tableau des réponses valides pour cet élément de grille |
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
GridItem
: doublon de GridItem
, 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
getColumns()
Récupère les valeurs de chaque colonne de la grille.
Aller-retour
String[]
: tableau de valeurs de colonne que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire
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
getRows()
Récupère les valeurs de chaque ligne de la grille.
Aller-retour
String[]
: tableau de valeurs de ligne que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire
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
setColumns(columns)
Définit les colonnes de la grille en fonction d'un tableau de valeurs. Lève une exception si le tableau donné est vide.
Paramètres
Nom | Type | Description |
---|---|---|
columns | String[] | un tableau de valeurs de colonne, que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire |
Aller-retour
GridItem
: cet élément, pour le chaînage
Génère
Error
: si le tableau donné est null
ou vide
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
GridItem
: cet élément GridItem
, 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
GridItem
: é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
setRows(rows)
Définit les lignes de la grille en fonction d'un tableau de valeurs. Lève une exception si le tableau donné est vide.
Paramètres
Nom | Type | Description |
---|---|---|
rows | String[] | Tableau de valeurs de lignes, que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire |
Aller-retour
GridItem
: cet élément, pour le chaînage
Génère
Error
: si le tableau donné est null
ou vide
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
GridItem
: cet élément GridItem
, 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
setValidation(validation)
Définit la validation des données pour cet élément de la grille. La transmission de la valeur "null" ou d'une validation sans aucune fonction requise appelée supprimera toute validation antérieure.
Paramètres
Nom | Type | Description |
---|---|---|
validation | GridValidation | une grille Validation à appliquer à cet élément. |
Aller-retour
GridItem
: cet élément GridItem
, 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