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

Class ScaleItem

Pregunta que permite al encuestado elegir una opción de una secuencia numerada de botones. Se puede acceder a los elementos o crearlos desde un Form. Cuando se usan en un cuestionario, estos elementos que se califican.

// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
    .setBounds(1, 10);

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`createResponse(response)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de escala.
`duplicate()`	`ScaleItem`	Crea una copia de este elemento y la agrega al final del formulario.
`getGeneralFeedback()`	`QuizFeedback`	Devuelve el feedback que se muestra a los encuestados cuando responden una pregunta con calificación.
`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.
`getLeftLabel()`	`String`	Obtiene la etiqueta del límite inferior de la escala, si corresponde.
`getLowerBound()`	`Integer`	Obtiene el límite inferior de la escala.
`getPoints()`	`Integer`	Muestra la puntuación de un elemento calificable.
`getRightLabel()`	`String`	Obtiene la etiqueta del límite superior de la escala, si corresponde.
`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`.
`getUpperBound()`	`Integer`	Obtiene el límite superior de la escala.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setBounds(lower, upper)`	`ScaleItem`	Establece los límites inferior y superior de la escala.
`setGeneralFeedback(feedback)`	`ScaleItem`	Hace que los comentarios se muestren a los encuestados cuando responden una pregunta con calificación que no tiene una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
`setHelpText(text)`	`ScaleItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setLabels(lower, upper)`	`ScaleItem`	Establece etiquetas para los límites inferior y superior de la escala.
`setPoints(points)`	`ScaleItem`	Establece la cantidad de puntos que vale un elemento con calificación.
`setRequired(enabled)`	`ScaleItem`	Establece si el encuestado debe responder la pregunta.
`setTitle(title)`	`ScaleItem`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de un `SectionHeaderItem`).

Documentación detallada

`createResponse(response)`

Crea un ItemResponse nuevo para este elemento de escala. Muestra una excepción si el argumento response está fuera de los límites establecidos para el elemento.

Parámetros

Nombre	Tipo	Descripción
`response`	`Integer`	una respuesta de valor para este elemento de escala

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

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

`getGeneralFeedback()`

Devuelve el feedback que se muestra a los encuestados cuando responden una pregunta con calificación.

Volver

QuizFeedback: Son los comentarios, 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 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

`getLeftLabel()`

Obtiene la etiqueta del límite inferior de la escala, si corresponde.

Volver

String: Es la etiqueta del límite inferior de la escala.

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

`getLowerBound()`

Obtiene el límite inferior de la escala.

Volver

Integer: Es el límite inferior de la escala.

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 calificable.

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

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

`getRightLabel()`

Obtiene la etiqueta del límite superior de la escala, si corresponde.

Volver

String: Es la etiqueta del límite superior de la escala.

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

`getUpperBound()`

Obtiene el límite superior de la escala.

Volver

Integer: Es el límite superior de la escala.

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

`setBounds(lower, upper)`

Establece los límites inferior y superior de la escala. El límite inferior debe ser 0 o 1. El límite superior debe estar entre 3 y 10, inclusive. De forma predeterminada, una báscula nueva límite inferior de 1 y límite superior de 5.

Muestra una excepción de secuencia de comandos si los valores especificados están fuera de los límites permitidos. Decimales se truncan al número entero anterior.

Parámetros

Nombre	Tipo	Descripción
`lower`	`Integer`	el nuevo límite inferior
`upper`	`Integer`	el nuevo límite superior

Volver

ScaleItem: este ScaleItem, para encadenamiento

Arroja

Error: Si el límite inferior o superior no es válido.

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

`setGeneralFeedback(feedback)`

Hace que los comentarios se muestren a los encuestados cuando responden una pregunta con calificación que no tiene una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	el nuevo comentario

Volver

ScaleItem: este ScaleItem, 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 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

ScaleItem: este ScaleItem, 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

`setLabels(lower, upper)`

Establece etiquetas para los límites inferior y superior de la escala.

Parámetros

Nombre	Tipo	Descripción
`lower`	`String`	la nueva etiqueta para el límite inferior
`upper`	`String`	la etiqueta nueva para el límite superior

Volver

ScaleItem: este ScaleItem, 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 con calificación. 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 una pregunta

Volver

ScaleItem: este ScaleItem, 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

ScaleItem: 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 un SectionHeaderItem).

Parámetros

Nombre	Tipo	Descripción
`title`	`String`	el nuevo título o texto del encabezado

Volver

ScaleItem: este ScaleItem, 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