Se usó la API de Cloud Translation para traducir esta página.

Class GridItem

Una pregunta, presentada como una cuadrícula de columnas y filas, que permite que el encuestado seleccione 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 cuadrícula.
`duplicate()`	`GridItem`	Crea una copia de este elemento y la agrega al final del formulario.
`getColumns()`	`String[]`	Obtiene los valores para cada columna de la cuadrícula.
`getHelpText()`	`String`	Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para 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 en la cuadrícula.
`getTitle()`	`String`	Obtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un `SectionHeaderItem`).
`getType()`	`ItemType`	Obtiene el tipo del elemento, representado como un `ItemType`.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setColumns(columns)`	`GridItem`	Establece las columnas de la cuadrícula en función de un array de valores.
`setHelpText(text)`	`GridItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción 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 en función de un array de valores.
`setTitle(title)`	`GridItem`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de un `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.

Volver

GridItem: este elemento 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

`createResponse(responses)`

Crea un ItemResponse nuevo para este elemento de cuadrícula. El argumento responses debe ser un Es el array String[] que contiene 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 a esa fila. Arroja un 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

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.

Volver

GridItem: Es un duplicado de este GridItem, 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

`getColumns()`

Obtiene los valores para cada columna de la cuadrícula.

Volver

String[]: Es un array de valores de columna, que las personas 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 de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: Es el texto de ayuda o 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.

Volver

Integer: Es el ID 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

`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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRows()`

Obtiene los valores de cada fila en la cuadrícula.

Volver

String[]: Es un array de valores de fila, que las personas 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 de encabezado, en el caso de un SectionHeaderItem).

Volver

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 un ItemType.

Volver

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.

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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setColumns(columns)`

Establece las columnas de la cuadrícula en función de un array de valores. Arroja una excepción si el valor proporcionado el array 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

GridItem: este elemento para el encadenamiento

Arroja

Error: Si el array dado 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 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 de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	el nuevo texto de ayuda

Volver

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

Volver

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 en función de un array 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 verán como etiquetas cuando visualicen el formulario.

Volver

GridItem: este elemento para el encadenamiento

Arroja

Error: Si el array dado 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 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 un SectionHeaderItem).

Parámetros

Nombre	Tipo	Descripción
`title`	`String`	el nuevo título o texto del encabezado

Volver

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. Pasar un valor nulo o una validación sin ningún Requerir funciones llamadas quitará cualquier validación previa.

Parámetros

Nombre	Tipo	Descripción
`validation`	`GridValidation`	una GridValidation para aplicar a este elemento.

Volver

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