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

Class CheckboxItem

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