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

Class ListItem

Es un elemento de pregunta que permite que el encuestado seleccione una opción de una lista desplegable. Se puede acceder a los elementos o crearlos desde un Form.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`createChoice(value)`	`Choice`	Crea una opción nueva.
`createChoice(value, isCorrect)`	`Choice`	Crea una opción nueva.
`createChoice(value, navigationItem)`	`Choice`	Crea una opción nueva con una opción de navegación de páginas que salta a un elemento de salto de página determinado.
`createChoice(value, navigationType)`	`Choice`	Crea una opción nueva con una opción de navegación de páginas.
`createResponse(response)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de lista.
`duplicate()`	`ListItem`	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 se muestran a los encuestados cuando responden correctamente una pregunta.
`getFeedbackForIncorrect()`	`QuizFeedback`	Muestra los comentarios que se muestran a los encuestados cuando responden incorrectamente una pregunta.
`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.
`getPoints()`	`Integer`	Muestra el valor en puntos 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 un `SectionHeaderItem`).
`getType()`	`ItemType`	Obtiene el tipo del elemento, representado como un `ItemType`.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setChoiceValues(values)`	`ListItem`	Establece las opciones de un elemento a partir de un array de cadenas.
`setChoices(choices)`	`ListItem`	Establece un array de opciones para un elemento.
`setFeedbackForCorrect(feedback)`	`ListItem`	Establece los comentarios que se mostrarán a las personas que responden cuando respondan correctamente una pregunta.
`setFeedbackForIncorrect(feedback)`	`ListItem`	Establece los comentarios que se mostrarán a las personas que responden cuando respondan incorrectamente una pregunta.
`setHelpText(text)`	`ListItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setPoints(points)`	`ListItem`	Establece la cantidad de puntos que vale un elemento que se puede calificar.
`setRequired(enabled)`	`ListItem`	Establece si el encuestado debe responder la pregunta.
`setTitle(title)`	`ListItem`	Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un `SectionHeaderItem`).

Documentación detallada

`createChoice(value)`

Crea una opción nueva.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la opción, que los encuestados ven como una etiqueta cuando ven el formulario

Volver

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

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

`createChoice(value, isCorrect)`

Crea una opción nueva.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la opción, que los encuestados ven como una etiqueta cuando ven el formulario
`isCorrect`	`Boolean`	si la opción es una respuesta correcta

Volver

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

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

`createChoice(value, navigationItem)`

Crea una opción nueva con una opción de navegación de páginas que salta a un elemento de salto de página determinado. Esto equivale a createChoice(value, navigationType) con navigationType establecido en FormApp.PageNavigationType.GO_TO_PAGE. Las opciones que usan la navegación por página no se pueden combinar en el mismo elemento con opciones que no usan la navegación por página.

La navegación por páginas se produce después de que el encuestado completa una página que contiene la opción y solo si la eligió. Si el encuestado eligió varias opciones con instrucciones de navegación en la misma página, solo la última opción de navegación tendrá efecto. La navegación de páginas tampoco tiene efecto en la última página de un formulario.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la opción, que los encuestados ven como una etiqueta cuando ven el formulario
`navigationItem`	`PageBreakItem`	el elemento al que se debe navegar

Volver

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

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

`createChoice(value, navigationType)`

Crea una opción nueva con una opción de navegación de páginas. Las opciones que usan la navegación de páginas no se pueden combinar en el mismo elemento con opciones que no la usan.

Parámetros

Nombre	Tipo	Descripción
`value`	`String`	el valor de la opción, que los encuestados ven como una etiqueta cuando ven el formulario
`navigationType`	`PageNavigationType`	el tipo de navegación de la opción

Volver

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

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

`createResponse(response)`

Crea un ItemResponse nuevo para este elemento de lista. Genera una excepción si el argumento response no coincide con una opción válida para este elemento.

Parámetros

Nombre	Tipo	Descripción
`response`	`String`	una respuesta válida para este elemento de lista

Volver

ItemResponse: Es la respuesta 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

`duplicate()`

Crea una copia de este elemento y la agrega al final del formulario.

Volver

ListItem: Es un duplicado de este ListItem 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

`getChoices()`

Obtiene todas las opciones de un elemento.

Volver

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

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

`getFeedbackForCorrect()`

Muestra los comentarios que se muestran a los encuestados cuando responden correctamente una pregunta.

Volver

QuizFeedback: Los comentarios, si los hay.

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

`getFeedbackForIncorrect()`

Muestra los comentarios que se muestran a los encuestados cuando responden incorrectamente una pregunta.

Volver

QuizFeedback: Los comentarios, si los hay.

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

`getPoints()`

Muestra el valor en puntos de un elemento que se puede calificar.

Volver

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

`setChoiceValues(values)`

Establece las opciones de un elemento a partir de un array de cadenas. Arroja una excepción si el array determinado está vacío.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parámetros

Nombre	Tipo	Descripción
`values`	`String[]`	el array de valores de elección, que los encuestados ven como etiquetas cuando ven el formulario

Volver

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

`setChoices(choices)`

Establece un array de opciones para un elemento. Genera una excepción si el array proporcionado está vacío o contiene un elemento null.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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

Volver

ListItem: Este ListItem, para encadenar

Arroja

Error: Si el array proporcionado 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 ámbitos:

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

`setFeedbackForCorrect(feedback)`

Establece los comentarios que se mostrarán a las personas que responden cuando respondan correctamente una pregunta.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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`	los comentarios nuevos. Si el valor es nulo, se borrarán los comentarios.

Volver

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

`setFeedbackForIncorrect(feedback)`

Establece los comentarios que se mostrarán a las personas que responden cuando respondan incorrectamente una pregunta.

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	los comentarios nuevos

Volver

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

`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

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

`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 un elemento de pregunta

Volver

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

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

`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 título o el texto del encabezado nuevos

Volver

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