Es un elemento de pregunta que permite que el encuestado elija una opción de una secuencia numerada de botones de selección. Se puede acceder a los elementos o crearlos desde una Form. Cuando se usan en un cuestionario, estos elementos 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 la escala. |
duplicate() | ScaleItem | Crea una copia de este elemento y la agrega al final del formulario. |
getGeneralFeedback() | QuizFeedback | Muestra los comentarios que se muestran a los encuestados cuando responden a una pregunta que se puede calificar. |
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. |
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 que se puede calificar. |
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 del encabezado, en el caso de SectionHeaderItem). |
getType() | ItemType | Obtiene el tipo del elemento, representado como ItemType. |
getUpperBound() | Integer | Obtiene el límite superior de la báscula. |
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 | Configura los comentarios que se mostrarán a los encuestados cuando respondan a una pregunta calificable 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 descriptivo 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 que se puede calificar. |
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 SectionHeaderItem). |
Documentación detallada
createResponse(response)
Crea un ItemResponse nuevo para este elemento de la 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 la escala |
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
ScaleItem: Es un duplicado de 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
getGeneralFeedback()
Muestra los comentarios que se muestran a los encuestados cuando responden a una pregunta que se puede calificar.
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
getLeftLabel()
Obtiene la etiqueta del límite inferior de la escala, si corresponde.
Devolvedor
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.
Devolvedor
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 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
getRightLabel()
Obtiene la etiqueta del límite superior de la escala, si corresponde.
Devolvedor
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 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
getUpperBound()
Obtiene el límite superior de la báscula.
Devolvedor
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.
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
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. Una escala nueva tiene un límite inferior de 1 y un límite superior de 5 de forma predeterminada.
Muestra una excepción de secuencia de comandos si los valores especificados están fuera de los límites permitidos. Los 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 |
Devolvedor
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)
Configura los comentarios que se mostrarán a los encuestados cuando respondan a una pregunta calificable 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 |
Devolvedor
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 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
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 nueva etiqueta para el límite superior |
Devolvedor
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 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
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 |
Devolvedor
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 SectionHeaderItem).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
title | String | el nuevo título o texto del encabezado |
Devolvedor
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