Class DurationItem

Duración del elemento

Es un elemento de pregunta que permite que el encuestado indique un período. Se puede acceder a los elementos o crearlos desde un Form. Cuando se usan en un cuestionario, se califican. 

// Open a form by ID and add a new duration item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');

Métodos

MétodoTipo de datos que se muestraDescripción breve
createResponse(hours, minutes, seconds)ItemResponseCrea un ItemResponse nuevo para este elemento de fecha.
duplicate()DurationItemCrea una copia de este elemento y la agrega al final del formulario.
getGeneralFeedback()QuizFeedbackMuestra los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.
getHelpText()StringObtiene el texto de ayuda del elemento (a veces llamado texto de descripción para 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.
getPoints()IntegerMuestra el valor en puntos de un elemento que se puede calificar.
getTitle()StringObtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un SectionHeaderItem).
getType()ItemTypeObtiene el tipo del elemento, representado como un ItemType.
isRequired()BooleanDetermina si el encuestado debe responder la pregunta.
setGeneralFeedback(feedback)DurationItemEstablece 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).
setHelpText(text)DurationItemEstablece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).
setPoints(points)DurationItemEstablece la cantidad de puntos que vale un elemento que se puede calificar.
setRequired(enabled)DurationItemEstablece si el encuestado debe responder la pregunta.
setTitle(title)DurationItemEstablece el título del elemento (a veces llamado texto del encabezado, en el caso de un SectionHeaderItem).

Documentación detallada

createResponse(hours, minutes, seconds)

Crea un ItemResponse nuevo para este elemento de fecha. Los argumentos hours, minutes y seconds se representan mejor como números enteros del 0 al 72 para hours y del 0 al 59 para minutes y seconds. Los valores que superan esos límites se limitan: por ejemplo, 24, 60, 90 se interpreta como 24:59:59.

Parámetros

NombreTipoDescripción
hoursIntegerlas horas, representadas como un número entero de 0 a 72
minutesIntegerlos minutos, representados como un número entero de 0 a 59
secondsIntegerlos segundos, representados como un número entero de 0 a 59

Volver

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

DurationItem: Es un duplicado de este DurationItem 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

QuizFeedback: 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 ImageItems, PageBreakItems y SectionHeaderItems).

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

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

getTitle()

Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un SectionHeaderItem).

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 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 á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

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

NombreTipoDescripción
feedbackQuizFeedbacklos comentarios nuevos

Volver

DurationItem: Este DurationItem, 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 ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

NombreTipoDescripción
textStringel nuevo texto de ayuda

Volver

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

NombreTipoDescripción
pointsIntegerla cantidad de puntos que vale un elemento de pregunta

Volver

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

NombreTipoDescripción
enabledBooleansi el encuestado debe responder la pregunta

Volver

DurationItem: 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 SectionHeaderItem).

Parámetros

NombreTipoDescripción
titleStringel título o el texto del encabezado nuevos

Volver

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