Class ScaleItem

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
ScaleItem

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étodoTipo de datos que se muestraDescripción breve
createResponse(response)ItemResponseCrea un ItemResponse nuevo para este elemento de escala.
duplicate()ScaleItemCrea una copia de este elemento y la adjunta al final del formulario.
getGeneralFeedback()QuizFeedbackMuestra los comentarios que se muestran a los encuestados cuando responden a una pregunta calificable.
getHelpText()StringObtiene 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()IntegerObtiene el identificador único del artículo.
getIndex()IntegerObtiene el índice del elemento entre todos los elementos del formulario.
getLeftLabel()StringObtiene la etiqueta para el límite inferior de la escala, si corresponde.
getLowerBound()IntegerObtiene el límite inferior de la escala.
getPoints()IntegerMuestra la puntuación de un elemento calificable.
getRightLabel()StringObtiene la etiqueta para el límite superior de la escala, si corresponde.
getTitle()StringObtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem).
getType()ItemTypeObtiene el tipo del elemento, representado como ItemType.
getUpperBound()IntegerObtiene el límite superior de la escala.
isRequired()BooleanDetermina si el encuestado debe responder la pregunta.
setBounds(lower, upper)ScaleItemEstablece los límites inferior y superior de la escala.
setGeneralFeedback(feedback)ScaleItemEstablece 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)ScaleItemEstablece 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)ScaleItemEstablece etiquetas para los límites inferior y superior de la escala.
setPoints(points)ScaleItemEstablece la cantidad de puntos que vale un elemento calificado.
setRequired(enabled)ScaleItemEstablece si el encuestado debe responder la pregunta.
setTitle(title)ScaleItemEstablece 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

NombreTipoDescripción
responseIntegeruna 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

NombreTipoDescripción
lowerIntegerel nuevo límite inferior
upperIntegerel 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

NombreTipoDescripción
feedbackQuizFeedbacklos 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

NombreTipoDescripción
textStringel 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

NombreTipoDescripción
lowerStringla nueva etiqueta para el límite inferior
upperStringla 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

NombreTipoDescripción
pointsIntegerla 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

NombreTipoDescripción
enabledBooleansi 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

NombreTipoDescripción
titleStringel 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