Question, présentée sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée de sélectionner un choix par ligne à partir d'une séquence de cases d'option. Les éléments sont accessibles ou créés à partir d'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 toute validation des données pour cet élément de 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'une 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 | 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'une SectionHeaderItem). |
setValidation(validation) | GridItem | Définit la validation des données pour cet élément de grille. |
Documentation détaillée
clearValidation()
Supprime toute validation des données pour cet élément de grille.
Renvois
GridItem : cet élément, pour l'enchaînement
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 dans la grille. Un élément null pour une question de grille non obligatoire indique l'absence de réponse pour cette ligne. La fonction renvoie une exception si l'une des valeurs ne correspond pas à un choix valide.
Paramètres
| Nom | Type | Description |
|---|---|---|
responses | String[] | un tableau de réponses valides pour cet élément de la grille |
Renvois
ItemResponse : réponse à l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
GridItem : doublon de ce GridItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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.
Renvois
String[] : tableau de valeurs de colonne, que les répondants voient comme des libellés lorsqu'ils consultent le formulaire
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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.
Renvois
Integer : ID de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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.
Renvois
String[] : tableau de valeurs de ligne, que les répondants voient comme des libellés lorsqu'ils consultent le formulaire
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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.
Renvois
ItemType : type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 associée à 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. La fonction renvoie une exception si le tableau donné est vide.
Paramètres
| Nom | Type | Description |
|---|---|---|
columns | String[] | un tableau de valeurs de colonnes que les répondants voient comme des libellés lorsqu'ils consultent le formulaire ; |
Renvois
GridItem : cet élément, pour l'enchaînement
Génère
Error : si le tableau donné est null ou vide
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
GridItem : cette GridItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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
GridItem : élément actuel (pour l'enchaînement)
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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. Génère une exception si le tableau donné est vide.
Paramètres
| Nom | Type | Description |
|---|---|---|
rows | String[] | Un tableau de valeurs de ligne, que les répondants voient comme des libellés lorsqu'ils consultent le formulaire |
Renvois
GridItem : cet élément, pour l'enchaînement
Génère
Error : si le tableau donné est null ou vide
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 SectionHeaderItem).
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | le nouveau titre ou texte de l'en-tête |
Renvois
GridItem : cette GridItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à 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 grille. La transmission d'une valeur nulle ou d'une validation sans aucune fonction d'exigence appelée supprime toute validation antérieure.
Paramètres
| Nom | Type | Description |
|---|---|---|
validation | GridValidation | une GridValidation à appliquer à cet élément. |
Renvois
GridItem : cette GridItem, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms