Class RatingItem

RatingItem

Es un elemento de pregunta que permite al encuestado dar una calificació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
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

Métodos

Método	Tipo de datos que se muestra	Descripción breve
createResponse(response)	ItemResponse	Crea un objeto ItemResponse nuevo para este elemento de calificación.
duplicate()	RatingItem	Crea una copia de este elemento y la agrega al final del formulario.
getGeneralFeedback()	QuizFeedback	Devuelve los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.
getHelpText()	String	Obtiene el texto de ayuda del elemento (a veces, se denomina texto de descripción para 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.
getPoints()	Integer	Devuelve el valor de puntos de un elemento calificable.
getRatingIcon()	RatingIconType	Obtiene el ícono elegido para la calificación.
getRatingScaleLevel()	Integer	Obtiene el nivel de la escala de calificación.
getTitle()	String	Obtiene el título del elemento (a veces, se denomina texto del encabezado, en el caso de un SectionHeaderItem).
getType()	ItemType	Obtiene el tipo del elemento, representado como un ItemType.
isRequired()	Boolean	Determina si el encuestado debe responder la pregunta.
setGeneralFeedback(feedback)	RatingItem	Establece los comentarios que se mostrarán a los encuestados cuando respondan una pregunta calificable que no tenga una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
setHelpText(text)	RatingItem	Establece el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).
setPoints(points)	RatingItem	Establece la cantidad de puntos que vale un elemento calificable.
setRatingIcon(ratingIcon)	RatingItem	Establece el ícono de la calificación.
setRatingScaleLevel(ratingScaleLevel)	RatingItem	Establece el nivel máximo de la escala de calificación.
setRequired(enabled)	RatingItem	Establece si el encuestado debe responder la pregunta.
setTitle(title)	RatingItem	Establece el título del elemento (a veces, se denomina texto del encabezado, en el caso de un SectionHeaderItem).

Documentación detallada

createResponse(response)

Crea un objeto ItemResponse nuevo para este elemento de calificación.

Genera una excepción de secuencia de comandos si el response proporcionado es menor que 1 o mayor que el valor que muestra getRatingScaleLevel().

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

Parámetros

Nombre	Tipo	Descripción
response	Integer	Es una respuesta de valor para este elemento de calificación.

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 agrega al final del formulario.

Volver

RatingItem: Duplicado de este RatingItem, 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()

Devuelve los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.

Volver

QuizFeedback: Es la opinión, si la hay.

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, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: Texto de ayuda o 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.

Volver

Integer: Es el ID 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

---

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

---

getPoints()

Devuelve el valor de puntos de un elemento calificable.

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 alcances:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getRatingIcon()

Obtiene el ícono elegido para la calificación.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

Volver

RatingIconType: Es el tipo de ícono de calificación.

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

---

getRatingScaleLevel()

Obtiene el nivel de la escala de calificación.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

Volver

Integer: Es el nivel de la escala de calificación.

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, se denomina texto del encabezado, en el caso de un SectionHeaderItem).

Volver

String: 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 un ItemType.

Volver

ItemType: 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 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

---

setGeneralFeedback(feedback)

Establece los comentarios que se mostrarán a los encuestados 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	QuizFeedback	los comentarios nuevos

Volver

RatingItem: Este RatingItem, 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, se denomina texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

Nombre	Tipo	Descripción
text	String	El nuevo texto de ayuda

Volver

RatingItem: Este RatingItem, 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 calificable. 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

RatingItem: Este RatingItem, 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

---

setRatingIcon(ratingIcon)

Establece el ícono de la calificación.

Arroja una excepción de secuencias de comandos si el tipo de ícono de clasificación no es válido.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

Parámetros

Nombre	Tipo	Descripción
ratingIcon	RatingIconType	Es el tipo de ícono de clasificación.

Volver

RatingItem: Este RatingItem, para el encadenamiento.

Arroja

Error: Si el tipo de ícono de calificación 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

---

setRatingScaleLevel(ratingScaleLevel)

Establece el nivel máximo de la escala de calificación. El nivel máximo de la escala de calificación debe estar entre 3 y 10, ambos incluidos. Una nueva calificación se establece de forma predeterminada en un nivel de escala de calificación de 3.

Arroja una excepción de secuencias de comandos si los valores proporcionados están fuera de los límites permitidos.

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

Parámetros

Nombre	Tipo	Descripción
ratingScaleLevel	Integer	Es el nivel de la escala de calificación.

Volver

RatingItem: Este RatingItem, para el encadenamiento.

Arroja

Error: Si el nivel de la escala de calificación 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

---

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

RatingItem: 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, se denomina texto del encabezado, en el caso de un SectionHeaderItem).

Parámetros

Nombre	Tipo	Descripción
title	String	El nuevo título o texto del encabezado

Volver

RatingItem: Este RatingItem, 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