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 |
---|---|---|
create | Item | Crea un objeto Item nuevo para este elemento de calificación. |
duplicate() | Rating | Crea una copia de este elemento y la agrega al final del formulario. |
get | Quiz | Devuelve los comentarios que se muestran a los encuestados cuando responden una pregunta calificable. |
get | String | Obtiene el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como Image , Page y Section ). |
get | Integer | Obtiene el identificador único del elemento. |
get | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
get | Integer | Devuelve el valor de puntos de un elemento calificable. |
get | Rating | Obtiene el ícono elegido para la calificación. |
get | Integer | Obtiene el nivel de la escala de calificación. |
get | String | Obtiene el título del elemento (a veces, se denomina texto del encabezado, en el caso de un Section ). |
get | Item | Obtiene el tipo del elemento, representado como un Item . |
is | Boolean | Determina si el encuestado debe responder la pregunta. |
set | Rating | 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). |
set | Rating | Establece el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como Image , Page y Section ). |
set | Rating | Establece la cantidad de puntos que vale un elemento calificable. |
set | Rating | Establece el ícono de la calificación. |
set | Rating | Establece el nivel máximo de la escala de calificación. |
set | Rating | Establece si el encuestado debe responder la pregunta. |
set | Rating | Establece el título del elemento (a veces, se denomina texto del encabezado, en el caso de un Section ). |
Documentación detallada
create Response(response)
Crea un objeto Item
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 get
.
// 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
Item
: 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
Rating
: Duplicado de este Rating
, 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
get General Feedback()
Devuelve los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.
Volver
Quiz
: 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
get Help Text()
Obtiene el texto de ayuda del elemento (a veces, se denomina texto de descripción para elementos de diseño como Image
, Page
y Section
).
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
get Id()
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
get Index()
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
get Points()
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
get Rating Icon()
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
Rating
: 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
get Rating Scale Level()
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
get Title()
Obtiene el título del elemento (a veces, se denomina texto del encabezado, en el caso de un Section
).
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
get Type()
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
is Required()
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
set General Feedback(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 | Quiz | los comentarios nuevos |
Volver
Rating
: Este Rating
, 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
set Help Text(text)
Establece el texto de ayuda del elemento (a veces, se denomina 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
Rating
: Este Rating
, 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
set Points(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
Rating
: Este Rating
, 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
set Rating Icon(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 |
---|---|---|
rating | Rating | Es el tipo de ícono de clasificación. |
Volver
Rating
: Este Rating
, 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
set Rating Scale Level(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 |
---|---|---|
rating | Integer | Es el nivel de la escala de calificación. |
Volver
Rating
: Este Rating
, 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
set Required(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
Rating
: 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
set Title(title)
Establece el título del elemento (a veces, se denomina texto del encabezado, en el caso de un Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | El nuevo título o texto del encabezado |
Volver
Rating
: Este Rating
, 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