Class GridItem

GridItem.

Un elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite a los encuestados seleccionar 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.
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étodoTipo de datos que se muestraDescripción breve
clearValidation()GridItemQuita toda validación de datos de este elemento de la cuadrícula.
createResponse(responses)ItemResponseCrea un ItemResponse nuevo para este elemento de la cuadrícula.
duplicate()GridItemCrea una copia de este elemento y la adjunta al final del formulario.
getColumns()String[]Obtiene los valores para cada columna de la cuadrícula.
getHelpText()StringObtiene el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).
getId()IntegerObtiene el identificador único del artículo.
getIndex()IntegerObtiene el índice del elemento entre todos los elementos del formulario.
getRows()String[]Obtiene los valores para cada fila de la cuadrícula.
getTitle()StringObtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem).
getType()ItemTypeObtiene el tipo del elemento, representado como ItemType.
isRequired()BooleanDetermina si el encuestado debe responder la pregunta.
setColumns(columns)GridItemEstablece las columnas de la cuadrícula en función de un arreglo de valores.
setHelpText(text)GridItemEstablece el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).
setRequired(enabled)GridItemEstablece si el encuestado debe responder la pregunta.
setRows(rows)GridItemEstablece las filas de la cuadrícula en función de un arreglo de valores.
setTitle(title)GridItemEstablece el título del elemento (a veces llamado texto de encabezado, en el caso de SectionHeaderItem).
setValidation(validation)GridItemEstablece la validación de datos para este elemento de la cuadrícula.

Documentación detallada

clearValidation()

Quita toda validación de datos de este elemento de la cuadrícula.

Volver

GridItem: Este elemento se usa para cadenas

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 arreglo String[] que contenga tantos valores como el número 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. Genera una excepción si alguno de los valores no coincide con una opción válida.

Parámetros

NombreTipoDescripción
responsesString[]un arreglo 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 adjunta 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 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 arreglo de valores de columna, que los encuestados ven como etiquetas cuando consultan 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 los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

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

Volver

Integer: 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.

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 para cada fila de la cuadrícula.

Volver

String[]: Es un arreglo de valores de fila que los encuestados pueden ver como etiquetas cuando consultan 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: 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 alcances:

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

getType()

Obtiene el tipo del elemento, representado como ItemType.

Volver

ItemType: 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 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 arreglo de valores. Genera una excepción si el arreglo está vacío.

Parámetros

NombreTipoDescripción
columnsString[]un arreglo de valores de columna, que los encuestados ven como etiquetas al visualizar el formulario

Volver

GridItem: Este elemento se usa para cadenas

Arroja

Error: Si el arreglo especificado 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 los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

NombreTipoDescripción
textStringel 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 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

NombreTipoDescripción
enabledBooleansi 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 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 arreglo de valores. Genera una excepción si el arreglo está vacío.

Parámetros

NombreTipoDescripción
rowsString[]un arreglo de valores de fila, que los encuestados consideran etiquetas al visualizar el formulario

Volver

GridItem: Este elemento se usa para cadenas

Arroja

Error: Si el arreglo especificado 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 SectionHeaderItem).

Parámetros

NombreTipoDescripción
titleStringel nuevo título o texto del encabezado

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 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 ninguna función requerida, se quitará la validación anterior.

Parámetros

NombreTipoDescripción
validationGridValidationuna 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 alcances:

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