Una pregunta que permite al encuestado seleccionar una o más casillas de verificación, así como un campo opcional "otro". Se puede acceder a los elementos o crearlos desde una Form
. Cuando se usan en un cuestionario, estos elementos se califican automáticamente.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
clearValidation() | CheckboxItem | Quita cualquier validación de datos para este elemento de la casilla de verificación. |
createChoice(value) | Choice | Crea una nueva opción. |
createChoice(value, isCorrect) | Choice | Crea una nueva opción. |
createResponse(responses) | ItemResponse | Crea un ItemResponse nuevo para este elemento de la casilla de verificación. |
duplicate() | CheckboxItem | Crea una copia de este elemento y la agrega al final del formulario. |
getChoices() | Choice[] | Obtiene todas las opciones de un elemento. |
getFeedbackForCorrect() | QuizFeedback | Muestra los comentarios que ven los encuestados cuando responden correctamente a una pregunta. |
getFeedbackForIncorrect() | QuizFeedback | Muestra los comentarios que ven los encuestados cuando responden de forma incorrecta a una pregunta. |
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. |
getPoints() | Integer | Muestra la puntuación de un elemento que se puede calificar. |
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 . |
hasOtherOption() | Boolean | Determina si el elemento tiene la opción "Otro". |
isRequired() | Boolean | Determina si el encuestado debe responder la pregunta. |
setChoiceValues(values) | CheckboxItem | Establece las opciones de un elemento de un array de cadenas. |
setChoices(choices) | CheckboxItem | Establece un array de opciones para un elemento. |
setFeedbackForCorrect(feedback) | CheckboxItem | Establece los comentarios para que se muestren a los encuestados cuando responden correctamente a una pregunta. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Establece que los comentarios se muestren a los encuestados cuando respondan incorrectamente a una pregunta. |
setHelpText(text) | CheckboxItem | Establece el texto de ayuda del elemento (a veces llamado texto descriptivo para elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Establece la cantidad de puntos que vale un elemento que se puede calificar. |
setRequired(enabled) | CheckboxItem | Establece si el encuestado debe responder la pregunta. |
setTitle(title) | CheckboxItem | Establece el título del elemento (a veces llamado texto de encabezado, en el caso de SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Establece la validación de datos para este elemento de la casilla de verificación. |
showOtherOption(enabled) | CheckboxItem | Establece si el elemento tiene la opción "Otro". |
Documentación detallada
clearValidation()
Quita cualquier validación de datos para este elemento de la casilla de verificación.
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
createChoice(value)
Crea una nueva opción.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
value | String | el valor de la opción, que los encuestados ven como una etiqueta al ver el formulario |
Devolvedor
Choice
es la nueva opción.
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
createChoice(value, isCorrect)
Crea una nueva opción.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
value | String | el valor de la opción, que los encuestados ven como una etiqueta al ver el formulario |
isCorrect | Boolean | si la respuesta es correcta |
Devolvedor
Choice
es la nueva opción.
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 casilla de verificación. El argumento responses
es un array String[]
que contiene valores que se deben verificar. Muestra una excepción si algún valor no coincide con una opción válida para este elemento, a menos que showOtherOption(enabled)
se establezca en true
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
responses | String[] | una matriz de respuestas válidas para este elemento de opción múltiple |
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
CheckboxItem
: Es un duplicado de este CheckboxItem
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
getChoices()
Obtiene todas las opciones de un elemento.
Devolvedor
Choice[]
: Es un array de opciones.
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
getFeedbackForCorrect()
Muestra los comentarios que ven los encuestados cuando responden correctamente a una pregunta.
Devolvedor
QuizFeedback
: Es el comentario, si corresponde.
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
getFeedbackForIncorrect()
Muestra los comentarios que ven los encuestados cuando responden incorrectamente a una pregunta.
Devolvedor
QuizFeedback
: Es el comentario, si corresponde.
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
getPoints()
Muestra la puntuación de un elemento que se puede calificar.
Devolvedor
Integer
: Es la cantidad de puntos que vale una 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
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
hasOtherOption()
Determina si el elemento tiene la opción "Otro".
Devolvedor
Boolean
: Es true
si el elemento tiene una opción "otro"; false
si no lo tiene.
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
setChoiceValues(values)
Establece las opciones de un elemento de un array de cadenas. Muestra una excepción si el array dado está vacío.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
values | String[] | la matriz de valores de opciones, que los encuestados ven como etiquetas al visualizar el formulario |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
setChoices(choices)
Establece un array de opciones para un elemento. Muestra una excepción si el array dado está vacío o contiene un elemento null
.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
choices | Choice[] | un array de opciones |
Devolvedor
CheckboxItem
: Este CheckboxItem
, para encadenamiento
Arroja
Error
: si el array dado es null
, está vacío o contiene un elemento null
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
setFeedbackForCorrect(feedback)
Establece los comentarios para que se muestren a los encuestados cuando responden correctamente a una pregunta.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | QuizFeedback | el nuevo feedback. Si el valor es nulo, se borrarán los comentarios. |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
setFeedbackForIncorrect(feedback)
Establece que los comentarios se muestren a los encuestados cuando respondan incorrectamente a una pregunta.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | QuizFeedback | el nuevo comentario |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
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
CheckboxItem
: Este CheckboxItem
, 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
setPoints(points)
Establece la cantidad de puntos que vale un elemento que se puede calificar. El valor predeterminado para los elementos nuevos es 0.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
points | Integer | la cantidad de puntos que vale una pregunta |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
CheckboxItem
: 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
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
CheckboxItem
: Este CheckboxItem
, 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 casilla de verificación. 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 | CheckboxValidation | una CheckboxValidation para aplicar a este elemento. |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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
showOtherOption(enabled)
Establece si el elemento tiene la opción "Otro". El valor predeterminado para un objeto CheckboxItem
o MultipleChoiceItem
nuevo es false
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
enabled | Boolean | true si el elemento tiene una opción "other"; false si no lo tiene |
Devolvedor
CheckboxItem
: Este CheckboxItem
, 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