Se usó la API de Cloud Translation para traducir esta página.

Interface Item

Un elemento de formulario genérico que contiene propiedades comunes a todos los elementos, como el título y el texto de ayuda. Puedes acceder a los elementos o crearlos desde Form.

Para operar en propiedades específicas de un tipo, usa getType() a fin de verificar el ItemType del elemento y, luego, convierte el elemento en la clase adecuada con un método como asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Cómo implementar clases

Nombre	Descripción breve

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`asCheckboxGridItem()`	`CheckboxGridItem`	Muestra el elemento como una cuadrícula con una casilla de verificación.
`asCheckboxItem()`	`CheckboxItem`	Muestra el elemento como una casilla de verificación.
`asDateItem()`	`DateItem`	Muestra el elemento como un elemento de fecha.
`asDateTimeItem()`	`DateTimeItem`	Muestra el elemento como un elemento de fecha y hora.
`asDurationItem()`	`DurationItem`	Muestra el elemento como un elemento de duración.
`asGridItem()`	`GridItem`	Muestra el elemento como un elemento de cuadrícula.
`asImageItem()`	`ImageItem`	Muestra el elemento como elemento de imagen.
`asListItem()`	`ListItem`	Muestra el elemento como un elemento de la lista.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Muestra el elemento como de opción múltiple.
`asPageBreakItem()`	`PageBreakItem`	Muestra el elemento como un salto de página.
`asParagraphTextItem()`	`ParagraphTextItem`	Muestra el elemento como un elemento de texto de párrafo.
`asScaleItem()`	`ScaleItem`	Muestra el elemento como elemento de escala.
`asSectionHeaderItem()`	`SectionHeaderItem`	Muestra el elemento como un encabezado de sección.
`asTextItem()`	`TextItem`	Muestra el elemento como un elemento de texto.
`asTimeItem()`	`TimeItem`	Muestra el elemento como un elemento de tiempo.
`asVideoItem()`	`VideoItem`	Muestra el elemento como elemento de video.
`duplicate()`	`Item`	Crea una copia de este elemento y la adjunta al final del formulario.
`getHelpText()`	`String`	Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`getId()`	`Integer`	Obtiene el identificador único del artículo.
`getIndex()`	`Integer`	Obtiene el índice del elemento entre todos los elementos del formulario.
`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 `ItemType`.
`setHelpText(text)`	`Item`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para los elementos de diseño, como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setTitle(title)`	`Item`	Establece el título del elemento (a veces llamado texto de encabezado, en el caso de `SectionHeaderItem`).

Documentación detallada

`asCheckboxGridItem()`

Muestra el elemento como una cuadrícula con una casilla de verificación. Muestra una excepción de secuencia de comandos si ItemType aún no era CHECKBOX_GRID.

Volver

CheckboxGridItem: Es el elemento de la cuadrícula de la casilla de verificación.

Arroja

Error: Si el elemento no es un elemento de la 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asCheckboxItem()`

Muestra el elemento como una casilla de verificación. Muestra una excepción de secuencia de comandos si ItemType aún no era CHECKBOX.

Volver

CheckboxItem: Es el elemento de la casilla de verificación.

Arroja

Error: si el elemento no es un elemento de 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asDateItem()`

Muestra el elemento como un elemento de fecha. Muestra una excepción de secuencia de comandos si ItemType aún no era DATE.

Volver

DateItem: el elemento de fecha

Arroja

Error: Si el elemento no es una fecha

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

`asDateTimeItem()`

Muestra el elemento como un elemento de fecha y hora. Muestra una excepción de secuencia de comandos si ItemType aún no era DATETIME.

Volver

DateTimeItem: el elemento de fecha y hora

Arroja

Error: Si el elemento no es un elemento 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asDurationItem()`

Muestra el elemento como un elemento de duración. Muestra una excepción de secuencia de comandos si ItemType aún no era DURATION.

Volver

DurationItem: el elemento de duración

Arroja

Error: si el elemento no es un elemento 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asGridItem()`

Muestra el elemento como un elemento de cuadrícula. Muestra una excepción de secuencia de comandos si ItemType aún no era GRID.

Volver

GridItem: el elemento de 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asImageItem()`

Muestra el elemento como elemento de imagen. Muestra una excepción de secuencia de comandos si ItemType aún no era IMAGE.

Volver

ImageItem: el elemento de imagen

Arroja

Error: Si el elemento no es un elemento de imagen.

`asListItem()`

Muestra el elemento como un elemento de la lista. Muestra una excepción de secuencia de comandos si ItemType aún no era LIST.

Volver

ListItem: Es el elemento de la lista.

Arroja

Error: Si el elemento no es un elemento de la lista.

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

`asMultipleChoiceItem()`

Muestra el elemento como de opción múltiple. Muestra una excepción de secuencia de comandos si ItemType aún no era MULTIPLE_CHOICE.

Volver

MultipleChoiceItem: Es el elemento de opción múltiple.

Arroja

Error: Si el elemento no es un elemento 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asPageBreakItem()`

Muestra el elemento como un salto de página. Muestra una excepción de secuencia de comandos si ItemType aún no era PAGE_BREAK.

Volver

PageBreakItem: Es el elemento de salto de página.

Arroja

Error: Si el elemento no es un 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 alcances:

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. Muestra una excepción de secuencia de comandos si ItemType aún no era PARAGRAPH_TEXT.

Volver

ParagraphTextItem: Es el elemento de texto del párrafo.

Arroja

Error: Si el elemento no es un párrafo.

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

`asScaleItem()`

Muestra el elemento como elemento de escala. Muestra una excepción de secuencia de comandos si ItemType aún no era SCALE.

Volver

ScaleItem: 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asSectionHeaderItem()`

Muestra el elemento como un encabezado de sección. Muestra una excepción de secuencia de comandos si ItemType aún no era SECTION_HEADER.

Volver

SectionHeaderItem: Es el elemento de encabezado de la sección.

Arroja

Error: Si el elemento no es un 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asTextItem()`

Muestra el elemento como un elemento de texto. Muestra una excepción de secuencia de comandos si ItemType aún no era TEXT.

Volver

TextItem: 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asTimeItem()`

Muestra el elemento como un elemento de tiempo. Muestra una excepción de secuencia de comandos si ItemType aún no era TIME.

Volver

TimeItem: el elemento de tiempo

Arroja

Error: si el elemento no es una hora

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

`asVideoItem()`

Muestra el elemento como elemento de video. Muestra una excepción de secuencia de comandos si ItemType aún no era VIDEO.

Volver

VideoItem: el elemento de video

Arroja

Error: Si el elemento no es un video

`duplicate()`

Crea una copia de este elemento y la adjunta 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 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 los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: el texto de ayuda o el texto de 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 artículo.

Volver

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

`getTitle()`

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

Volver

String: 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 alcances:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

Obtiene el tipo del elemento, representado como ItemType.

Volver

ItemType: 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 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 los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).

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

Parámetros

Nombre	Tipo	Descripción
`title`	`String`	el nuevo título o texto del encabezado

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

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms