Pregunta que permite al encuestado indicar una fecha y hora. Se puede acceder a los elementos
creado a partir de un Form
. Cuando se usan en un cuestionario, estos elementos se califican.
// Open a form by ID and add a new date-time item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateTimeItem(); item.setTitle('When do you want to meet?');
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
createResponse(response) | ItemResponse | Crea un ItemResponse nuevo para este elemento de fecha y hora. |
duplicate() | DateTimeItem | Crea una copia de este elemento y la agrega al final del formulario. |
getGeneralFeedback() | QuizFeedback | Devuelve el feedback que se muestra a los encuestados cuando responden una pregunta con calificación. |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado 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 | Muestra la puntuación de un elemento calificable. |
getTitle() | String | Obtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem ). |
getType() | ItemType | Obtiene el tipo del elemento, representado como un ItemType . |
includesYear() | Boolean | Determina si el elemento de fecha incluye una opción de año. |
isRequired() | Boolean | Determina si el encuestado debe responder la pregunta. |
setGeneralFeedback(feedback) | DateTimeItem | Hace que los comentarios se muestren a los encuestados cuando responden una pregunta con calificación que no tiene una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual). |
setHelpText(text) | DateTimeItem | Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como ImageItems , PageBreakItems y SectionHeaderItems ). |
setIncludesYear(enableYear) | DateTimeItem | Establece si el elemento de fecha incluye una configuración de año. |
setPoints(points) | DateTimeItem | Establece la cantidad de puntos que vale un elemento con calificación. |
setRequired(enabled) | DateTimeItem | Establece si el encuestado debe responder la pregunta. |
setTitle(title) | DateTimeItem | Establece el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem ). |
Documentación detallada
createResponse(response)
Crea un ItemResponse
nuevo para este elemento de fecha y hora. El campo de segundos del objeto Date
se ignora. de forma predeterminada, se usan los campos de año, mes, día, hora y minuto. Si
setIncludesYear(enabled)
se establece en false
, el año es
ignoradas también.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
response | Date | un objeto Date que representa un mes, un día, una hora, un minuto y, posiblemente,
año |
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
DateTimeItem
: Es un duplicado de este DateTimeItem
, para el 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 el feedback que se muestra a los encuestados cuando responden una pregunta con calificación.
Volver
QuizFeedback
: Son 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 elementos de diseño como ImageItems
, PageBreakItems
y SectionHeaderItems
).
Volver
String
: Es el 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()
Muestra la puntuación 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
getTitle()
Obtiene el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem
).
Volver
String
: Es el 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 de 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
includesYear()
Determina si el elemento de fecha incluye una opción de año.
Volver
Boolean
: true
si la fecha incluye una configuración de año. false
si no es así
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)
Hace que los comentarios se muestren a los encuestados cuando responden una pregunta con calificación que no tiene una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
feedback | QuizFeedback | el nuevo comentario |
Volver
DateTimeItem
: este DateTimeItem
, 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
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
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Volver
DateTimeItem
: este DateTimeItem
, 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
setIncludesYear(enableYear)
Establece si el elemento de fecha incluye una configuración de año. El valor predeterminado para los elementos de fecha nuevos es true
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
enableYear | Boolean | true si la fecha incluye una configuración de año. false si no es así |
Volver
DateTimeItem
: este DateTimeItem
, 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
setPoints(points)
Establece la cantidad de puntos que vale un elemento con calificación. 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 una pregunta |
Volver
DateTimeItem
: este DateTimeItem
, 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
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
DateTimeItem
: Es el elemento actual (para el 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
setTitle(title)
Establece el título del elemento (a veces llamado texto de encabezado, en el caso de un SectionHeaderItem
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el nuevo título o texto del encabezado |
Volver
DateTimeItem
: este DateTimeItem
, 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