Es un elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite al encuestado seleccionar una opción por fila de una secuencia de botones de selección. Se puede acceder a los elementos o crearlos desde una 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étodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
clearValidation() | GridItem | Quita cualquier validación de datos para este elemento de la cuadrícula. |
createResponse(responses) | ItemResponse | Crea un ItemResponse nuevo para este elemento de la cuadrícula. |
duplicate() | GridItem | Crea una copia de este elemento y la agrega al final del formulario. |
getColumns() | String[] | Obtiene los valores de cada columna de la cuadrícula. |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado texto descriptivo para los elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
getId() | Integer | Obtiene el identificador único del elemento. |
getIndex() | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
getRows() | String[] | Obtiene los valores de cada fila de la cuadrícula. |
getTitle() | String | Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de SectionHeaderItem ). |
getType() | ItemType | Obtiene el tipo del elemento, representado como ItemType . |
isRequired() | Boolean | Determina si el encuestado debe responder la pregunta. |
setColumns(columns) | GridItem | Configura las columnas de la cuadrícula en función de un arreglo de valores. |
setHelpText(text) | GridItem | Establece el texto de ayuda del elemento (a veces llamado texto descriptivo para elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
setRequired(enabled) | GridItem | Establece si el encuestado debe responder la pregunta. |
setRows(rows) | GridItem | Establece las filas de la cuadrícula según un arreglo de valores. |
setTitle(title) | GridItem | Establece el título del elemento (a veces llamado texto de encabezado, en el caso de SectionHeaderItem ). |
setValidation(validation) | GridItem | Establece la validación de datos para este elemento de la cuadrícula. |
Documentación detallada
clearValidation()
Quita cualquier validación de datos para este elemento de la cuadrícula.
Devolvedor
GridItem
: Este artículo, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
Crea un ItemResponse
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 en la cuadrícula. Un elemento null
para una pregunta de 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[] | una matriz de respuestas válidas para este elemento de la cuadrícula |
Devolvedor
ItemResponse
: Es la respuesta del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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.
Devolvedor
GridItem
: Es un duplicado de este GridItem
para encadenamiento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
Obtiene los valores de cada columna de la cuadrícula.
Devolvedor
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 alcances:
-
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 descriptivo para los elementos de diseño, como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Obtiene el identificador único del elemento.
Devolvedor
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 alcances:
-
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.
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRows()
Obtiene los valores de cada fila de la cuadrícula.
Devolvedor
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 alcances:
-
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 SectionHeaderItem
).
Devolvedor
String
: Es el título o 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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Obtiene el tipo del elemento, representado como ItemType
.
Devolvedor
ItemType
: Es el tipo de elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Determina si el encuestado debe responder la pregunta.
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
Configura las columnas de la cuadrícula en función de un arreglo de valores. Muestra una excepción si el array dado 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 |
Devolvedor
GridItem
: Este artículo, para encadenamiento
Arroja
Error
: si el array dado está null
o vacío
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 descriptivo para elementos de diseño, como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Devolvedor
GridItem
: Este GridItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 |
Devolvedor
GridItem
: Es el elemento actual (para el encadenamiento).
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
Establece las filas de la cuadrícula según un arreglo de valores. Muestra una excepción si el array dado está vacío.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
rows | String[] | un array de valores de fila, que los encuestados ven como etiquetas al ver el formulario |
Devolvedor
GridItem
: Este artículo, para encadenamiento
Arroja
Error
: si el array dado está null
o vacío
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 de encabezado, en el caso de SectionHeaderItem
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el nuevo título o texto del encabezado |
Devolvedor
GridItem
: Este GridItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 llamadas a ninguna función obligatorio, se quitará cualquier validación anterior.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
validation | GridValidation | una GridValidation para aplicar a este elemento. |
Devolvedor
GridItem
: Este GridItem
, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms