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