Un elemento de pregunta que permite que el encuestado elija una opción de una secuencia numerada de botones de selección. Puedes acceder a los elementos o crearlos desde 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 escala. |
duplicate() | ScaleItem | Crea una copia de este elemento y la adjunta al final del formulario. |
getGeneralFeedback() | QuizFeedback | Muestra los comentarios que se muestran a los encuestados cuando responden a una pregunta calificable. |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para los 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. |
getLeftLabel() | String | Obtiene la etiqueta para el 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 para el 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 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 | Establece 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 de descripción para los 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 calificado. |
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 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 adjunta al final del formulario.
Volver
ScaleItem: Es un duplicado de este ScaleItem para encadenar
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 calificable.
Volver
QuizFeedback: 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 los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).
Volver
String: el texto de ayuda o el texto de 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 artículo.
Volver
Integer: 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.
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 para el límite inferior de la escala, si corresponde.
Volver
String: Es la etiqueta para 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
getLowerBound()
Obtiene el límite inferior de la escala.
Volver
Integer: 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: 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 para el límite superior de la escala, si corresponde.
Volver
String: la etiqueta para 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
getTitle()
Obtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem).
Volver
String: 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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Obtiene el tipo del elemento, representado como ItemType.
Volver
ItemType: 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 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: 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 nueva escala tiene un límite inferior de 1 y un límite superior de 5.
Muestra una excepción de la 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 |
Volver
ScaleItem: este ScaleItem, para encadenar
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)
Establece 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 | los nuevos comentarios |
Volver
ScaleItem: este ScaleItem, para encadenar
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 los 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 encadenar
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 |
Volver
ScaleItem: este ScaleItem, para encadenar
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 calificado. 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 encadenar
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 encadenar).
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 |
Volver
ScaleItem: este ScaleItem, para encadenar
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