Es un elemento de pregunta que permite que la persona que responde elija una opción de una secuencia numerada de botones de selección. Se puede acceder a los elementos o crearlos desde un Form
. Cuando se usan en un cuestionario, estos elementos se califican.
// Open a form by ID and add a new scale item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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 |
---|---|---|
create | Item | Crea un Item nuevo para este elemento de escala. |
duplicate() | Scale | Crea una copia de este elemento y la agrega al final del formulario. |
get | Quiz | Muestra los comentarios que se muestran a los encuestados cuando responden una pregunta calificable. |
get | String | Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
get | Integer | Obtiene el identificador único del artículo. |
get | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
get | String | Obtiene la etiqueta del límite inferior de la escala, si corresponde. |
get | Integer | Obtiene el límite inferior de la escala. |
get | Integer | Muestra el valor en puntos de un elemento que se puede calificar. |
get | String | Obtiene la etiqueta del límite superior de la escala, si corresponde. |
get | String | Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
get | Item | Obtiene el tipo del elemento, representado como un Item . |
get | Integer | Obtiene el límite superior de la escala. |
is | Boolean | Determina si el encuestado debe responder la pregunta. |
set | Scale | Establece los límites inferior y superior de la escala. |
set | Scale | Establece los comentarios que se mostrarán a las personas que responden cuando respondan una pregunta calificable que no tenga una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual). |
set | Scale | Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
set | Scale | Establece etiquetas para los límites inferior y superior de la escala. |
set | Scale | Establece la cantidad de puntos que vale un elemento que se puede calificar. |
set | Scale | Establece si el encuestado debe responder la pregunta. |
set | Scale | Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
Documentación detallada
createResponse(response)
Crea un Item
nuevo para este elemento de escala. Genera 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
Item
: 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
Scale
: Es un duplicado de este Scale
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
getGeneralFeedback()
Muestra los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.
Volver
Quiz
: 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 Image
, Page
y Section
).
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
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 ámbitos:
-
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 á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
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 á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 Section
).
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 Item
.
Volver
Item
: 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
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 á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
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
, ambos inclusive. Una escala nueva tiene un límite inferior predeterminado de 1
y un límite superior de 5
.
Genera una excepción de secuencias de comandos si los valores proporcionados 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
Scale
: Este Scale
, 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 ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Establece los comentarios que se mostrarán a las personas que responden cuando respondan una pregunta calificable que no tenga una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | Quiz | los comentarios nuevos |
Volver
Scale
: Este Scale
, 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 Image
, Page
y Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Volver
Scale
: Este Scale
, 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
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
Scale
: Este Scale
, 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
Scale
: Este Scale
, 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
Scale
: 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 Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el título o el texto del encabezado nuevos |
Volver
Scale
: Este Scale
, 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