Permite que una secuencia de comandos abra un Form
existente o cree uno nuevo.
// Open a form by ID. const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. const newForm = FormApp.create('Form Name');
Propiedades
Propiedad | Tipo | Descripción |
---|---|---|
Alignment | Alignment | Es una enumeración de los tipos de alineación de imágenes. |
Destination | Destination | Es una enumeración de los tipos de destinos que pueden almacenar respuestas de formularios. |
Feedback | Feedback | Es una enumeración de tipos de formulario Feedbacks . |
Item | Item | Es una enumeración de tipos de formulario Items . |
Page | Page | Es una enumeración de los posibles comportamientos para navegar por las páginas. |
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
create(title) | Form | Crea y muestra un Form nuevo. |
create | Checkbox | Muestra una instancia de un CheckboxGridValidationBuilder que se puede usar para establecer la validación en un Checkbox . |
create | Checkbox | Muestra una instancia de un CheckboxValidationBuilder que se puede usar para establecer la validación en un Checkbox . |
create | Quiz | Muestra una instancia de un QuizFeedbackBuilder que se puede usar para establecer comentarios en un Item que se puede calificar. |
create | Grid | Muestra una instancia de un GridValidationBuilder que se puede usar para establecer la validación en un Grid . |
create | Paragraph | Muestra una instancia de un ParagraphTextValidationBuilder que se puede usar para establecer la validación en un Paragraph . |
create | Text | Muestra una instancia de TextValidationBuilder que se puede usar para establecer la validación en un Text . |
get | Form | Muestra el formulario al que la secuencia de comandos está vinculada al contenedor. |
get | Ui | Muestra una instancia del entorno de la interfaz de usuario del editor de formularios que permite que la secuencia de comandos agregue funciones como menús, diálogos y barras laterales. |
open | Form | Muestra el Form con el ID especificado. |
open | Form | Muestra el Form con la URL especificada. |
Documentación detallada
create(title)
Crea y muestra un Form
nuevo. Genera una excepción si el título determinado es null
o está vacío.
// Create and open a form. const form = FormApp.create('Form Name');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el nombre del nuevo formulario |
Volver
Form
: Es el formulario nuevo.
Arroja
Error
: Si el título determinado es null
o está vacío.
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
create Checkbox Grid Validation()
Muestra una instancia de un CheckboxGridValidationBuilder que se puede usar para establecer la validación en un Checkbox
.
Volver
create Checkbox Validation()
Muestra una instancia de un CheckboxValidationBuilder que se puede usar para establecer la validación en un Checkbox
.
Volver
create Feedback()
Muestra una instancia de un QuizFeedbackBuilder que se puede usar para establecer comentarios en un Item
que se puede calificar.
Volver
create Grid Validation()
Muestra una instancia de un GridValidationBuilder que se puede usar para establecer la validación en un Grid
.
Volver
create Paragraph Text Validation()
Muestra una instancia de un ParagraphTextValidationBuilder que se puede usar para establecer la validación en un Paragraph
.
Volver
create Text Validation()
Muestra una instancia de TextValidationBuilder que se puede usar para establecer la validación en un Text
.
Volver
get Active Form()
Muestra el formulario al que la secuencia de comandos está vinculada al contenedor. Para interactuar con formularios a los que la secuencia de comandos no está vinculada a un contenedor, usa open
o open
.
// Get the form to which this script is bound. const form = FormApp.getActiveForm();
Volver
Form
: Es el formulario al que está vinculada la secuencia de comandos, o null
si la secuencia de comandos no está vinculada a un formulario.
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
get Ui()
Muestra una instancia del entorno de la interfaz de usuario del editor de formularios que permite que la secuencia de comandos agregue funciones como menús, diálogos y barras laterales. Una secuencia de comandos solo puede interactuar con la IU de la instancia actual de un editor de formularios abierto (no la vista que ve un encuestado) y solo si la secuencia de comandos está vinculada al formulario. Para obtener más información, consulta las guías de menús y diálogos y barras laterales.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu( FormApp.getUi() .createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction'), ) .addToUi(); }
Volver
Ui
: Es una instancia del entorno de la interfaz de usuario de este formulario.
open By Id(id)
Muestra el Form
con el ID especificado. Genera una excepción si el ID no es válido o si el usuario no tiene permiso para abrir el formulario.
// Open a form by ID. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
id | String | el ID del formulario que se abrirá |
Volver
Form
: Es el formulario con el ID determinado.
Arroja
Error
: Si el ID proporcionado no es válido o el usuario no tiene permisos suficientes
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
open By Url(url)
Muestra el Form
con la URL especificada. Lanza una excepción si la URL no es válida o si el usuario no tiene permiso para abrir el formulario.
// Open a form by URL. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit', );
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
url | String | la URL del formulario que se abrirá |
Volver
Form
: Es el formulario con la URL determinada.
Arroja
Error
: Si la URL proporcionada no es válida o el usuario no tiene permisos suficientes.
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