Es un elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite que la persona que responde seleccione una opción por fila de una secuencia de botones de selección. Se puede acceder a los elementos o crearlos desde un Form
.
// Open a form by ID and add a new grid item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addGridItem(); item.setTitle('Rate your interests') .setRows(['Cars', 'Computers', 'Celebrities']) .setColumns(['Boring', 'So-so', 'Interesting']);
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
clear | Grid | Quita cualquier validación de datos de este elemento de la cuadrícula. |
create | Item | Crea un Item nuevo para este elemento de la cuadrícula. |
duplicate() | Grid | Crea una copia de este elemento y la agrega al final del formulario. |
get | String[] | Obtiene los valores de cada columna de la cuadrícula. |
get | String | Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
get | Integer | Obtiene el identificador único del artículo. |
get | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
get | String[] | Obtiene los valores de cada fila de la cuadrícula. |
get | String | Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
get | Item | Obtiene el tipo del elemento, representado como un Item . |
is | Boolean | Determina si el encuestado debe responder la pregunta. |
set | Grid | Establece las columnas de la cuadrícula según un array de valores. |
set | Grid | Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
set | Grid | Establece si el encuestado debe responder la pregunta. |
set | Grid | Establece las filas de la cuadrícula en función de un array de valores. |
set | Grid | Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
set | Grid | Establece la validación de datos para este elemento de la cuadrícula. |
Documentación detallada
clearValidation()
Quita cualquier validación de datos de este elemento de la cuadrícula.
Volver
Grid
: Este elemento, para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Crea un Item
nuevo para este elemento de la cuadrícula. El argumento responses
debe ser un array String[]
que contenga tantos valores como la cantidad de filas de la cuadrícula. Un elemento null
para una pregunta de la cuadrícula no obligatoria indica que no hay respuesta para esa fila. Genera una excepción si alguno de los valores no coincide con una opción válida.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
responses | String[] | Un array de respuestas válidas para este elemento de la cuadrícula |
Volver
Item
: Es la respuesta del artículo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Crea una copia de este elemento y la agrega al final del formulario.
Volver
Grid
: Es un duplicado de este Grid
para encadenar.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Obtiene los valores de cada columna de la cuadrícula.
Volver
String[]
: Es un array de valores de columna que los encuestados ven como etiquetas cuando ven el formulario.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image
, Page
y Section
).
Volver
String
: Es el texto de ayuda o la descripción del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Obtiene el identificador único del artículo.
Volver
Integer
: Es el ID del artículo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Obtiene el índice del elemento entre todos los elementos del formulario.
Volver
Integer
: Es el índice del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Obtiene los valores de cada fila de la cuadrícula.
Volver
String[]
: Es un array de valores de fila que los encuestados ven como etiquetas cuando ven el formulario.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un Section
).
Volver
String
: Es el título o el texto del encabezado del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Obtiene el tipo del elemento, representado como un Item
.
Volver
Item
: Es el tipo del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Determina si el encuestado debe responder la pregunta.
Volver
Boolean
: Indica si el encuestado debe responder la pregunta.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Establece las columnas de la cuadrícula según un array de valores. Arroja una excepción si el array determinado está vacío.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
columns | String[] | Un array de valores de columna que los encuestados ven como etiquetas cuando ven el formulario |
Volver
Grid
: Este elemento, para encadenar
Arroja
Error
: Si el array determinado es null
o está vacío.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image
, Page
y Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Volver
Grid
: Este Grid
, para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Establece si el encuestado debe responder la pregunta.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
enabled | Boolean | si el encuestado debe responder la pregunta |
Volver
Grid
: Es el elemento actual (para encadenar).
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Establece las filas de la cuadrícula en función de un array de valores. Arroja una excepción si el array determinado está vacío.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
rows | String[] | Un array de valores de fila que los encuestados ven como etiquetas cuando ven el formulario. |
Volver
Grid
: Este elemento, para encadenar
Arroja
Error
: Si el array determinado es null
o está vacío.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el título o el texto del encabezado nuevos |
Volver
Grid
: Este Grid
, para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Establece la validación de datos para este elemento de la cuadrícula. Si pasas un valor nulo o una validación sin llamar a ninguna función requerida, se quitará cualquier validación anterior.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
validation | Grid | un GridValidation para aplicar a este elemento. |
Volver
Grid
: Este Grid
, para encadenar
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms