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