Class Form

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

Un formulario que contiene elementos y propiedades generales Las propiedades incluyen el título, la configuración y dónde se almacenan las respuestas. Los elementos incluyen elementos de preguntas, como casillas de verificación o elementos de radio, mientras que los elementos de diseño hacen referencia a elementos como saltos de página. Puedes acceder a los formularios o crearlos desde FormApp.

// Open a form by ID and create a new spreadsheet.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var ss = SpreadsheetApp.create('Spreadsheet Name');

// Update form properties via chaining.
form.setTitle('Form Name')
    .setDescription('Description of form')
    .setConfirmationMessage('Thanks for responding!')
    .setAllowResponseEdits(true)
    .setAcceptingResponses(false);

// Update the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

Métodos

MétodoTipo de datos que se muestraDescripción breve
addCheckboxGridItem()CheckboxGridItemAgrega un nuevo elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite que el encuestado seleccione varias opciones por fila de una secuencia de casillas de verificación.
addCheckboxItem()CheckboxItemAgrega un elemento de pregunta nuevo que permite que el encuestado seleccione una o más casillas de verificación, así como un campo opcional (otro).
addDateItem()DateItemAgrega un elemento de pregunta nuevo que permite que el encuestado indique una fecha.
addDateTimeItem()DateTimeItemAgrega un nuevo elemento de pregunta que permite que el encuestado indique una fecha y hora.
addDurationItem()DurationItemAgrega un elemento de pregunta nuevo que permite que el encuestado indique un período de tiempo.
addEditor(emailAddress)FormAgrega el usuario determinado a la lista de editores de Form.
addEditor(user)FormAgrega el usuario determinado a la lista de editores de Form.
addEditors(emailAddresses)FormAgrega el arreglo de usuarios determinado a la lista de editores de Form.
addGridItem()GridItemAgrega un nuevo elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite que el encuestado seleccione una opción por fila de una secuencia de botones de selección.
addImageItem()ImageItemAgrega un nuevo elemento de diseño que muestra una imagen.
addListItem()ListItemAgrega un elemento de pregunta nuevo que permite que el encuestado seleccione una opción de una lista desplegable.
addMultipleChoiceItem()MultipleChoiceItemAgrega un elemento de pregunta nuevo que permite que el encuestado seleccione una opción de una lista de botones de selección o un campo opcional (otro).
addPageBreakItem()PageBreakItemAgrega un nuevo elemento de diseño que marca el inicio de una página.
addParagraphTextItem()ParagraphTextItemAgrega un nuevo elemento de pregunta que permite al encuestado ingresar un bloque de texto.
addScaleItem()ScaleItemAgrega un elemento de pregunta nuevo que permita que el encuestado elija una opción de una secuencia numerada de botones de selección.
addSectionHeaderItem()SectionHeaderItemAgrega un nuevo elemento de diseño que indique visualmente el inicio de una sección.
addTextItem()TextItemAgrega un elemento de pregunta nuevo que permite al encuestado ingresar una sola línea de texto.
addTimeItem()TimeItemAgrega un elemento de pregunta nuevo que permite que el encuestado indique una hora del día.
addVideoItem()VideoItemAgrega un nuevo elemento de diseño que muestra un video.
canEditResponse()BooleanDetermina si el formulario muestra un vínculo para editar una respuesta después de enviarla.
collectsEmail()BooleanDetermina si el formulario recopila las direcciones de correo electrónico de los encuestados.
createResponse()FormResponseCrea una respuesta nueva al formulario.
deleteAllResponses()FormElimina todas las respuestas enviadas del almacén de respuestas del formulario.
deleteItem(index)voidBorra el elemento de un índice determinado entre todos los elementos del formulario.
deleteItem(item)voidBorra el elemento especificado.
deleteResponse(responseId)FormElimina una sola respuesta del almacén de respuestas del formulario.
getConfirmationMessage()StringObtiene el mensaje de confirmación del formulario.
getCustomClosedFormMessage()StringObtiene el mensaje personalizado que se mostrará si el formulario no acepta respuestas o una string vacía si no se configuró ningún mensaje personalizado.
getDescription()StringObtiene la descripción del formulario.
getDestinationId()StringObtiene el ID del destino de la respuesta del formulario.
getDestinationType()DestinationTypeObtiene el tipo del destino de respuesta del formulario.
getEditUrl()StringObtiene la URL que se puede usar para acceder al modo de edición del formulario.
getEditors()User[]Obtiene la lista de editores para este Form.
getId()StringObtiene el ID del formulario.
getItemById(id)ItemObtiene el elemento con un ID determinado.
getItems()Item[]Obtiene un arreglo de todos los elementos del formulario.
getItems(itemType)Item[]Obtiene un arreglo de todos los elementos de un tipo determinado.
getPublishedUrl()StringObtiene la URL que se puede usar para responder al formulario.
getResponse(responseId)FormResponseObtiene una sola respuesta de formulario según su ID de respuesta.
getResponses()FormResponse[]Obtiene un arreglo de todas las respuestas del formulario.
getResponses(timestamp)FormResponse[]Obtiene un arreglo de todas las respuestas del formulario después de una fecha y hora determinadas.
getShuffleQuestions()BooleanDetermina si el orden de las preguntas en cada página del formulario es aleatorio.
getSummaryUrl()StringObtiene la URL que se puede usar para ver un resumen de las respuestas del formulario.
getTitle()StringObtiene el título del formulario.
hasLimitOneResponsePerUser()BooleanDetermina si el formulario permite solo una respuesta por encuestado.
hasProgressBar()BooleanDetermina si el formulario muestra una barra de progreso.
hasRespondAgainLink()BooleanDetermina si el formulario muestra un vínculo para enviar otra respuesta después de que un encuestado completa el formulario.
isAcceptingResponses()BooleanDetermina si el formulario acepta respuestas en este momento.
isPublishingSummary()BooleanDetermina si el formulario muestra un vínculo para ver un resumen de las respuestas después de que un encuestado completa el formulario.
isQuiz()BooleanDetermina si el formulario es un cuestionario.
moveItem(from, to)ItemMueve un elemento en un índice determinado entre todos los elementos del formulario a otro índice determinado.
moveItem(item, toIndex)ItemMueve un elemento determinado a un índice determinado entre todos los elementos del formulario.
removeDestination()FormDesvincula el formulario de su destino de respuesta actual.
removeEditor(emailAddress)FormQuita al usuario específico de la lista de editores de Form.
removeEditor(user)FormQuita al usuario específico de la lista de editores de Form.
requiresLogin()BooleanDetermina si el formulario requiere que los encuestados accedan a una cuenta en el mismo dominio o subdominio antes de responder.
setAcceptingResponses(enabled)FormEstablece si el formulario acepta respuestas en este momento.
setAllowResponseEdits(enabled)FormEstablece si el formulario muestra un vínculo para editar una respuesta después de enviarla.
setCollectEmail(collect)FormEstablece si el formulario recopila las direcciones de correo electrónico de los encuestados.
setConfirmationMessage(message)FormEstablece el mensaje de confirmación del formulario.
setCustomClosedFormMessage(message)FormConfigura el mensaje para que se muestre si el formulario no acepta respuestas.
setDescription(description)FormEstablece la descripción del formulario.
setDestination(type, id)FormEstablece el destino donde se guardan las respuestas del formulario.
setIsQuiz(enabled)FormEstablece si el formulario es un cuestionario.
setLimitOneResponsePerUser(enabled)FormEstablece si el formulario permite solo una respuesta por encuestado.
setProgressBar(enabled)FormEstablece si el formulario tiene una barra de progreso.
setPublishingSummary(enabled)FormEstablece si el formulario muestra un vínculo para ver un resumen de las respuestas después de que un encuestado envía el formulario.
setRequireLogin(requireLogin)FormEstablece si el formulario requiere que las personas accedan a una cuenta en el mismo dominio o un subdominio antes de responder.
setShowLinkToRespondAgain(enabled)FormEstablece si el formulario muestra un vínculo para enviar otra respuesta después de que un encuestado completa el formulario.
setShuffleQuestions(shuffle)FormEstablece si el orden de las preguntas en cada página del formulario es aleatorio.
setTitle(title)FormEstablece el título del formulario.
shortenFormUrl(url)StringConvierte una URL larga para un formulario en una URL corta.
submitGrades(responses)FormEnvía las calificaciones de las FormResponses dadas.

Documentación detallada

addCheckboxGridItem()

Agrega un nuevo elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite que el encuestado seleccione varias opciones por fila de una secuencia de casillas de verificación.

Volver

CheckboxGridItem: Es el elemento recién creado.

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

addCheckboxItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado seleccione una o más casillas de verificación, así como un campo opcional (otro).

Volver

CheckboxItem: Es el elemento recién creado.

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

addDateItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado indique una fecha.

Volver

DateItem: Es el elemento recién creado.

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

addDateTimeItem()

Agrega un nuevo elemento de pregunta que permite que el encuestado indique una fecha y hora.

Volver

DateTimeItem: Es el elemento recién creado.

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

addDurationItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado indique un período de tiempo.

Volver

DurationItem: Es el elemento recién creado.

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

addEditor(emailAddress)

Agrega el usuario determinado a la lista de editores de Form. Si el usuario ya estaba en la lista de usuarios, este método promociona al usuario fuera de la lista de espectadores.

Parámetros

NombreTipoDescripción
emailAddressStringLa dirección de correo electrónico del usuario que se agregará.

Volver

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

addEditor(user)

Agrega el usuario determinado a la lista de editores de Form. Si el usuario ya estaba en la lista de usuarios, este método promociona al usuario fuera de la lista de espectadores.

Parámetros

NombreTipoDescripción
userUserUna representación del usuario que se agregará.

Volver

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

addEditors(emailAddresses)

Agrega el arreglo de usuarios determinado a la lista de editores de Form. Si alguno de los usuarios ya estaba en la lista de usuarios, este método los promociona fuera de la lista de usuarios.

Parámetros

NombreTipoDescripción
emailAddressesString[]Un arreglo de direcciones de correo electrónico de los usuarios que se agregarán.

Volver

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

addGridItem()

Agrega un nuevo elemento de pregunta, presentado como una cuadrícula de columnas y filas, que permite que el encuestado seleccione una opción por fila de una secuencia de botones de selección.

Volver

GridItem: Es el elemento recién creado.

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

addImageItem()

Agrega un nuevo elemento de diseño que muestra una imagen.

Volver

ImageItem: Es el elemento recién creado.

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

addListItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado seleccione una opción de una lista desplegable.

Volver

ListItem: Es el elemento recién creado.

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

addMultipleChoiceItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado seleccione una opción de una lista de botones de selección o un campo opcional (otro).

Volver

MultipleChoiceItem: Es el elemento recién creado.

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

addPageBreakItem()

Agrega un nuevo elemento de diseño que marca el inicio de una página.

Volver

PageBreakItem: Es el elemento recién creado.

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

addParagraphTextItem()

Agrega un nuevo elemento de pregunta que permite al encuestado ingresar un bloque de texto.

Volver

ParagraphTextItem: Es el elemento recién creado.

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

addScaleItem()

Agrega un elemento de pregunta nuevo que permita que el encuestado elija una opción de una secuencia numerada de botones de selección.

Volver

ScaleItem: Es el elemento recién creado.

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

addSectionHeaderItem()

Agrega un nuevo elemento de diseño que indique visualmente el inicio de una sección.

Volver

SectionHeaderItem: Es el elemento recién creado.

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

addTextItem()

Agrega un elemento de pregunta nuevo que permite al encuestado ingresar una sola línea de texto.

Volver

TextItem: Es el elemento recién creado.

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

addTimeItem()

Agrega un elemento de pregunta nuevo que permite que el encuestado indique una hora del día.

Volver

TimeItem: Es el elemento recién creado.

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

addVideoItem()

Agrega un nuevo elemento de diseño que muestra un video.

Volver

VideoItem: Es el elemento recién creado.

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

canEditResponse()

Determina si el formulario muestra un vínculo para editar una respuesta después de enviarla.

Sin importar esta configuración, el método FormResponse.getEditResponseUrl() permite que un autor de secuencia de comandos con acceso de edición al formulario genere una URL que se puede usar para editar una respuesta.

Volver

Boolean: true si el formulario muestra un vínculo "Editar tu respuesta" false si no

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

collectsEmail()

Determina si el formulario recopila las direcciones de correo electrónico de los encuestados.

Volver

Boolean: true si el formulario recopila direcciones de correo electrónico; false si no

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

createResponse()

Crea una respuesta nueva al formulario. Para responder un elemento de pregunta, crea un ItemResponse a partir del elemento y, luego, llama a FormResponse.withItemResponse(response) para adjuntarlo a esta respuesta de formulario. Para guardar la respuesta que ensamblaste, llama a FormResponse.submit().

Volver

FormResponse: Es la respuesta del formulario recién creada.

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

deleteAllResponses()

Elimina todas las respuestas enviadas del almacén de respuestas del formulario. Este método no borra las copias de las respuestas almacenadas en un destino de respuesta externo (como una hoja de cálculo), pero borra la vista resumida del formulario.

Volver

Form: este Form, 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

deleteItem(index)

Borra el elemento de un índice determinado entre todos los elementos del formulario. Muestra una excepción de secuencias de comandos si no existe un elemento en el índice determinado.

Parámetros

NombreTipoDescripción
indexIntegerel índice del elemento entre todos los elementos del formulario

Arroja

Error: si no existe un elemento en el índice especificado

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

deleteItem(item)

Borra el elemento especificado. Muestra una excepción de secuencia de comandos si el elemento ya se borró.

Parámetros

NombreTipoDescripción
itemItemel elemento que se borrará

Arroja

Error: si el elemento no existe en el formulario

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

deleteResponse(responseId)

Elimina una sola respuesta del almacén de respuestas del formulario. Este método no borra las copias de las respuestas almacenadas en un destino de respuesta externa (como una hoja de cálculo), pero quita la respuesta de la vista de resumen del formulario. El ID de respuesta se puede recuperar con FormResponse.getId().

Parámetros

NombreTipoDescripción
responseIdStringel ID de la respuesta del formulario que se borrará

Volver

Form: este Form, 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

getConfirmationMessage()

Obtiene el mensaje de confirmación del formulario.

Volver

String: el mensaje de confirmación del formulario

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

getCustomClosedFormMessage()

Obtiene el mensaje personalizado que se mostrará si el formulario no acepta respuestas o una string vacía si no se configuró ningún mensaje personalizado.

Volver

String: El mensaje personalizado que se mostrará si el formulario no acepta respuestas o una string vacía si no se configuró ningún mensaje personalizado

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

getDescription()

Obtiene la descripción del formulario.

Volver

String: la descripción del formulario

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

getDestinationId()

Obtiene el ID del destino de la respuesta del formulario.

Volver

String: el ID del destino de la respuesta del formulario

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

getDestinationType()

Obtiene el tipo del destino de respuesta del formulario.

Volver

DestinationType: Es el tipo de destino de la respuesta del formulario.

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

getEditUrl()

Obtiene la URL que se puede usar para acceder al modo de edición del formulario.

Volver

String: Es la URL para editar el formulario.

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

getEditors()

Obtiene la lista de editores para este Form.

Volver

User[]: Es un arreglo de usuarios con permiso de edició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

getId()

Obtiene el ID del formulario.

Volver

String: Es el ID del formulario.

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

getItemById(id)

Obtiene el elemento con un ID determinado. Muestra null si el ID no corresponde a un elemento en el formulario.

Parámetros

NombreTipoDescripción
idIntegerel ID del artículo

Volver

Item: Es el elemento con el ID determinado o null si el elemento no existe en el formulario.

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

getItems()

Obtiene un arreglo de todos los elementos del formulario.

Volver

Item[]: Es un arreglo de todos los elementos del formulario.

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

getItems(itemType)

Obtiene un arreglo de todos los elementos de un tipo determinado.

Parámetros

NombreTipoDescripción
itemTypeItemTypeel tipo de elementos que se recuperarán

Volver

Item[]: Es un arreglo de todos los elementos de ese tipo.

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

getPublishedUrl()

Obtiene la URL que se puede usar para responder al formulario.

Volver

String: Es la URL para responder al formulario.

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

getResponse(responseId)

Obtiene una sola respuesta de formulario según su ID de respuesta. Los ID de respuesta se pueden recuperar de FormResponse.getId().

Parámetros

NombreTipoDescripción
responseIdStringel ID de la respuesta del formulario

Volver

FormResponse: Es la respuesta del formulario.

Arroja

Error: si la respuesta no existe

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

getResponses()

Obtiene un arreglo de todas las respuestas del formulario.

Volver

FormResponse[]: Es un arreglo de todas las respuestas del formulario.

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

getResponses(timestamp)

Obtiene un arreglo de todas las respuestas del formulario después de una fecha y hora determinadas.

Parámetros

NombreTipoDescripción
timestampDatela primera fecha y hora para la que se deben mostrar las respuestas del formulario

Volver

FormResponse[]: Es la lista de respuestas del formulario.

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

getShuffleQuestions()

Determina si el orden de las preguntas en cada página del formulario es aleatorio.

Volver

Boolean: true si el orden de las preguntas en cada página del formulario es aleatorio; false si no es aleatorio

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

getSummaryUrl()

Obtiene la URL que se puede usar para ver un resumen de las respuestas del formulario. A menos que setPublishingSummary(enabled) esté configurado como true, solo los usuarios con permiso de edición para el formulario podrán acceder a la URL.

Volver

String: Es la URL para ver un resumen de las respuestas.

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 formulario.

Volver

String: el título del formulario

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

hasLimitOneResponsePerUser()

Determina si el formulario permite solo una respuesta por encuestado. Si el valor es true, la secuencia de comandos no puede enviar respuestas del formulario.

Volver

Boolean: true si el formulario permite solo una respuesta por encuestado; false si no

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

hasProgressBar()

Determina si el formulario muestra una barra de progreso.

Volver

Boolean: true si el formulario muestra una barra de progreso; false si no

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

Determina si el formulario muestra un vínculo para enviar otra respuesta después de que un encuestado completa el formulario.

Volver

Boolean: true si el formulario muestra un vínculo "Enviar otra respuesta"; en caso contrario, false

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

isAcceptingResponses()

Determina si el formulario acepta respuestas en este momento.

Volver

Boolean: true si el formulario acepta respuestas; false si no

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

isPublishingSummary()

Determina si el formulario muestra un vínculo para ver un resumen de las respuestas después de que un encuestado completa el formulario.

Volver

Boolean: true si el formulario muestra un vínculo para ver las respuestas anteriores (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

isQuiz()

Determina si el formulario es un cuestionario.

Volver

Boolean: true si el formulario acepta respuestas; false si no

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

moveItem(from, to)

Mueve un elemento en un índice determinado entre todos los elementos del formulario a otro índice determinado. Genera una excepción de secuencia de comandos si el índice to está fuera de los límites.

Parámetros

NombreTipoDescripción
fromIntegerel índice actual del elemento entre todos los elementos del formulario
toIntegerel nuevo índice del elemento entre todos los elementos del formulario

Volver

Item: el elemento que se movió

Arroja

Error: Si alguno de los índices está fuera de los límites

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

moveItem(item, toIndex)

Mueve un elemento determinado a un índice determinado entre todos los elementos del formulario. Genera una excepción de secuencia de comandos si el índice determinado está fuera de los límites.

Parámetros

NombreTipoDescripción
itemItemel elemento que se moverá
toIndexIntegerel nuevo índice del elemento entre todos los elementos del formulario

Volver

Item: el elemento que se movió

Arroja

Error: si el índice está fuera de los límites

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

removeDestination()

Desvincula el formulario de su destino de respuesta actual. El destino anterior desvinculado aún conserva una copia de todas las respuestas anteriores. Todos los formularios, incluidos los que no tienen un destino establecido de forma explícita, guardan una copia de las respuestas en el almacén de respuestas del formulario. Si el formulario no tiene un destino de respuesta, este método no tiene efecto.

Volver

Form: este Form, 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

removeEditor(emailAddress)

Quita al usuario específico de la lista de editores de Form. Este método no impide que los usuarios accedan a Form si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si Form se comparte con todo el dominio del usuario o si el Form está en una unidad compartida a la que el usuario puede acceder.

En el caso de los archivos de Drive, también se quita al usuario de la lista de lectores.

Parámetros

NombreTipoDescripción
emailAddressStringLa dirección de correo electrónico del usuario que se quitará.

Volver

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

removeEditor(user)

Quita al usuario específico de la lista de editores de Form. Este método no impide que los usuarios accedan a Form si pertenecen a una clase de usuarios que tienen acceso general, por ejemplo, si Form se comparte con todo el dominio del usuario o si el Form está en una unidad compartida a la que el usuario puede acceder.

En el caso de los archivos de Drive, también se quita al usuario de la lista de lectores.

Parámetros

NombreTipoDescripción
userUserUna representación del usuario que se quitará.

Volver

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

requiresLogin()

Determina si el formulario requiere que los encuestados accedan a una cuenta en el mismo dominio o subdominio antes de responder.

Volver

Boolean: true si el formulario requiere que los usuarios accedan; false si no


setAcceptingResponses(enabled)

Establece si el formulario acepta respuestas en este momento. El valor predeterminado para los formularios nuevos es true.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe aceptar respuestas; false si no lo hace

Volver

Form: este Form, 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

setAllowResponseEdits(enabled)

Establece si el formulario muestra un vínculo para editar una respuesta después de enviarla. El valor predeterminado para los formularios nuevos es false.

Sin importar esta configuración, el método FormResponse.getEditResponseUrl() permite que un autor de la secuencia de comandos con permiso de edición del formulario genere una URL que se puede usar para editar una respuesta.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe mostrar un vínculo "Editar tu respuesta" false si no

Volver

Form: este Form, 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

setCollectEmail(collect)

Establece si el formulario recopila las direcciones de correo electrónico de los encuestados. El valor predeterminado para los formularios nuevos es false.

Parámetros

NombreTipoDescripción
collectBooleantrue si el formulario debe recopilar direcciones de correo electrónico; false si no lo hace

Volver

Form: este Form, 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

setConfirmationMessage(message)

Establece el mensaje de confirmación del formulario.

Parámetros

NombreTipoDescripción
messageStringel nuevo mensaje de confirmación del formulario

Volver

Form: este Form, 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

setCustomClosedFormMessage(message)

Configura el mensaje para que se muestre si el formulario no acepta respuestas. Si no se configura ningún mensaje, el formulario usará un mensaje predeterminado.

Parámetros

NombreTipoDescripción
messageStringel mensaje que se mostrará si el formulario no acepta respuestas

Volver

Form: este Form, 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

setDescription(description)

Establece la descripción del formulario.

Parámetros

NombreTipoDescripción
descriptionStringla nueva descripción del formulario

Volver

Form: este Form, 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

setDestination(type, id)

Establece el destino donde se guardan las respuestas del formulario. Todos los formularios, incluidos los que no tienen un destino establecido de forma explícita, guardan una copia de las respuestas en el almacén de respuestas del formulario.

Parámetros

NombreTipoDescripción
typeDestinationTypeel tipo de destino de la respuesta del formulario
idStringel ID del destino de la respuesta del formulario

Volver

Form: este Form, para encadenar

Arroja

Error: si el ID de destino proporcionado 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

setIsQuiz(enabled)

Establece si el formulario es un cuestionario. El valor predeterminado para los formularios nuevos es false.

Las preguntas con calificación solo se permiten en Cuestionarios, por lo que, si la estableces como falsa, se quitarán todas las opciones de calificación de todas las preguntas.

La configuración de Quiz solo está disponible en la nueva IU de Formularios. Si conviertes un formulario en un cuestionario, se habilitará el uso de la nueva IU en el formulario.

Parámetros

NombreTipoDescripción
enabledBooleantrue si se deben habilitar las funciones de cuestionario para el formulario; false si no se deben habilitar

Volver

Form: este Form, 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

setLimitOneResponsePerUser(enabled)

Establece si el formulario permite solo una respuesta por encuestado. El valor predeterminado para los formularios nuevos es false. Si el valor se establece en true, la secuencia de comandos no puede enviar respuestas del formulario.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe permitir solo una respuesta por encuestado; false si no se permite

Volver

Form: este Form, 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

setProgressBar(enabled)

Establece si el formulario tiene una barra de progreso. El valor predeterminado para los formularios nuevos es false.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe mostrar una barra de progreso; false si no

Volver

Form: este Form, 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

setPublishingSummary(enabled)

Establece si el formulario muestra un vínculo para ver un resumen de las respuestas después de que un encuestado envía el formulario. El valor predeterminado para los formularios nuevos es false.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe mostrar el vínculo "Ver respuestas anteriores"; false si no es así

Volver

Form: este Form, 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

setRequireLogin(requireLogin)

Establece si el formulario requiere que las personas accedan a una cuenta en el mismo dominio o un subdominio antes de responder. El valor predeterminado para los formularios nuevos es false, a menos que un administrador de dominio lo cambie.

Esta función solo está disponible para formularios creados por usuarios de Google Workspace. No es necesario que los usuarios de otros tipos de Cuentas de Google accedan.

Parámetros

NombreTipoDescripción
requireLoginBooleantrue si el formulario requiere que los usuarios accedan; false si no

Volver

Form: Es el formulario 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

setShowLinkToRespondAgain(enabled)

Establece si el formulario muestra un vínculo para enviar otra respuesta después de que un encuestado completa el formulario. El valor predeterminado para los formularios nuevos es true.

Parámetros

NombreTipoDescripción
enabledBooleantrue si el formulario debe mostrar el vínculo "Enviar otra respuesta"; de lo contrario, false

Volver

Form: este Form, 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

setShuffleQuestions(shuffle)

Establece si el orden de las preguntas en cada página del formulario es aleatorio.

Parámetros

NombreTipoDescripción
shuffleBooleantrue si el orden de las preguntas en cada página del formulario debe ser aleatorio; false si no es aleatorio

Volver

Form: este Form, 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 formulario.

Parámetros

NombreTipoDescripción
titleStringel nuevo título del formulario

Volver

Form: este Form, 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

shortenFormUrl(url)

Convierte una URL larga para un formulario en una URL corta. Muestra una excepción si la URL larga no pertenece a Formularios de Google.

Parámetros

NombreTipoDescripción
urlString

Volver

String: Es una URL con el formato http://goo.gl/forms/1234.

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

submitGrades(responses)

Envía las calificaciones de las FormResponses dadas.

Si tu código incluye un activador onFormSubmit, llamar a submitGrades() activa la condición onFormSubmit y genera un bucle infinito. Para evitar el bucle infinito, agrega código que verifique si ya existen calificaciones antes de llamar a submitGrades().

Parámetros

NombreTipoDescripción
responsesFormResponse[]

Volver

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