Es un elemento de formulario genérico que contiene propiedades comunes a todos los elementos, como el título y el texto de ayuda.
Se puede acceder a los elementos o crearlos desde un Form
.
Para operar en propiedades específicas del tipo, usa get
para verificar el Item
del elemento y, luego, transfiérelo a la clase adecuada con un método como as
.
// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();
// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];
// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
const textItem = item.asTextItem();
textItem.setRequired(false);
}
Implementa clases
Nombre | Descripción breve |
---|
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
as | Checkbox | Muestra el elemento como un elemento de cuadrícula de casilla de verificación. |
as | Checkbox | Muestra el elemento como una casilla de verificación. |
as | Date | Muestra el elemento como un elemento de fecha. |
as | Date | Muestra el elemento como un elemento de fecha y hora. |
as | Duration | Muestra el elemento como un elemento de duración. |
as | Grid | Muestra el elemento como un elemento de cuadrícula. |
as | Image | Devuelve el elemento como un elemento de imagen. |
as | List | Muestra el elemento como un elemento de lista. |
as | Multiple | Muestra el elemento como uno de opción múltiple. |
as | Page | Muestra el elemento como un elemento de salto de página. |
as | Paragraph | Muestra el elemento como un elemento de texto de párrafo. |
as | Rating | Muestra el elemento como un elemento de calificación. |
as | Scale | Muestra el elemento como un elemento de escala. |
as | Section | Muestra el elemento como un elemento de encabezado de sección. |
as | Text | Muestra el elemento como un elemento de texto. |
as | Time | Muestra el elemento como un elemento de hora. |
as | Video | Muestra el elemento como un elemento de video. |
duplicate() | Item | Crea una copia de este elemento y la agrega al final del formulario. |
get | String | Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
get | Integer | Obtiene el identificador único del artículo. |
get | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
get | String | Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
get | Item | Obtiene el tipo del elemento, representado como un Item . |
set | Item | Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image , Page y Section ). |
set | Item | Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un Section ). |
Documentación detallada
asCheckboxGridItem()
Muestra el elemento como un elemento de cuadrícula de casilla de verificación. Genera una excepción de secuencia de comandos si el Item
no era CHECKBOX_GRID
.
Volver
Checkbox
: Es el elemento de la cuadrícula de casillas de verificación.
Arroja
Error
: Si el elemento no es un elemento de cuadrícula de casillas de verificación.
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
asCheckboxItem()
Muestra el elemento como una casilla de verificación. Genera una excepción de secuencia de comandos si el Item
no era CHECKBOX
.
Volver
Checkbox
: Es el elemento de la casilla de verificación.
Arroja
Error
: Si el elemento no es una casilla de verificación.
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
asDateItem()
Muestra el elemento como un elemento de fecha. Genera una excepción de secuencia de comandos si el Item
no era DATE
.
Volver
Date
: Es el elemento de fecha.
Arroja
Error
: Si el elemento no es un elemento de fecha
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
asDateTimeItem()
Muestra el elemento como un elemento de fecha y hora. Genera una excepción de secuencia de comandos si el Item
no era DATETIME
.
Volver
Date
: Es el elemento de fecha y hora.
Arroja
Error
: Si el elemento no es de fecha y hora
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
asDurationItem()
Muestra el elemento como un elemento de duración. Genera una excepción de secuencia de comandos si el Item
no era DURATION
.
Volver
Duration
: Es el elemento de duración.
Arroja
Error
: Si el elemento no es de duración
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
asGridItem()
Muestra el elemento como un elemento de cuadrícula. Genera una excepción de secuencia de comandos si el Item
no era GRID
.
Volver
Grid
: Es el elemento de la cuadrícula.
Arroja
Error
: Si el elemento no es un elemento de cuadrícula
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
asImageItem()
asListItem()
Muestra el elemento como un elemento de lista. Genera una excepción de secuencia de comandos si el Item
no era LIST
.
Volver
List
: Es el elemento de la lista.
Arroja
Error
: Si el elemento no es un elemento de lista
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
asMultipleChoiceItem()
Muestra el elemento como uno de opción múltiple. Genera una excepción de secuencia de comandos si el Item
no era MULTIPLE_CHOICE
.
Volver
Multiple
: Es el elemento de opción múltiple.
Arroja
Error
: Si el elemento no es de opción múltiple
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
asPageBreakItem()
Muestra el elemento como un elemento de salto de página. Genera una excepción de secuencia de comandos si el Item
no era PAGE_BREAK
.
Volver
Page
: Es el elemento de salto de página.
Arroja
Error
: Si el elemento no es un elemento de salto de página.
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
asParagraphTextItem()
Muestra el elemento como un elemento de texto de párrafo. Genera una excepción de secuencia de comandos si el Item
no era PARAGRAPH_TEXT
.
Volver
Paragraph
: Es el elemento de texto de párrafo.
Arroja
Error
: Si el elemento no es un elemento de texto de párrafo.
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
asRatingItem()
Muestra el elemento como un elemento de calificación. Muestra una ScriptingException si el Item
no era RATING
.
// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');
// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];
// Convert the item to a rating item.
const ratingItem = item.asRatingItem();
Volver
Rating
: Es el elemento de calificación.
Arroja
Error
: Si el elemento no es un elemento 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 ámbitos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asScaleItem()
Muestra el elemento como un elemento de escala. Genera una excepción de secuencia de comandos si el Item
no era SCALE
.
Volver
Scale
: Es el elemento de escala.
Arroja
Error
: Si el elemento no es un elemento de escala
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
asSectionHeaderItem()
Muestra el elemento como un elemento de encabezado de sección. Genera una excepción de secuencia de comandos si el Item
no era SECTION_HEADER
.
Volver
Section
: Es el elemento de encabezado de la sección.
Arroja
Error
: Si el elemento no es un elemento de encabezado de sección
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
asTextItem()
Muestra el elemento como un elemento de texto. Genera una excepción de secuencia de comandos si el Item
no era TEXT
.
Volver
Text
: Es el elemento de texto.
Arroja
Error
: Si el elemento no es un elemento de texto
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
asTimeItem()
Muestra el elemento como un elemento de hora. Genera una excepción de secuencia de comandos si el Item
no era TIME
.
Volver
Time
: Es el elemento de hora.
Arroja
Error
: Si el elemento no es un elemento de tiempo
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
asVideoItem()
duplicate()
Crea una copia de este elemento y la agrega al final del formulario.
Volver
Item
: Es un duplicado de este Item
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
getHelpText()
Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como Image
, Page
y Section
).
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
getTitle()
Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un Section
).
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 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 á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 Image
, Page
y Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | el nuevo texto de ayuda |
Volver
Item
: Este Item
, 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 Section
).
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
title | String | el título o el texto del encabezado nuevos |
Volver
Item
: Este Item
, 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