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

Class GridItem

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
`clearValidation()`	`GridItem`	Quita cualquier validación de datos de 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 de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`getId()`	`Integer`	Obtiene el identificador único del artículo.
`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 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 según 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 del 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 de este elemento de la cuadrícula.

Volver

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

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 á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

GridItem: Es un duplicado de este GridItem 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 ImageItems, PageBreakItems y SectionHeaderItems).

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 SectionHeaderItem).

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

Volver

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

GridItem: 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 ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

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

Volver

GridItem: Este GridItem, 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

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

GridItem: 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 SectionHeaderItem).

Parámetros

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

Volver

GridItem: Este GridItem, 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`	`GridValidation`	un GridValidation para aplicar a este elemento.

Volver

GridItem: Este GridItem, 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