Questa pagina è stata tradotta dall'API Cloud Translation.

Interface Item

Un elemento di modulo generico che contiene proprietà comuni a tutti gli elementi, come il titolo e il testo di aiuto. È possibile accedere agli elementi o crearli da un Form.

Per operare su proprietà specifiche del tipo, utilizza getType() per controllare il ItemType dell'elemento, quindi esegui il passaggio dell'elemento alla classe appropriata utilizzando un metodo come asCheckboxItem().

// 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);
}

Implementazione di classi

Nome	Breve descrizione

Metodi

Metodo	Tipo restituito	Breve descrizione
`asCheckboxGridItem()`	`CheckboxGridItem`	Restituisce l'elemento come elemento della griglia di caselle di controllo.
`asCheckboxItem()`	`CheckboxItem`	Restituisce l'elemento come elemento di casella di controllo.
`asDateItem()`	`DateItem`	Restituisce l'elemento come elemento data.
`asDateTimeItem()`	`DateTimeItem`	Restituisce l'elemento come elemento data/ora.
`asDurationItem()`	`DurationItem`	Restituisce l'elemento come elemento di durata.
`asGridItem()`	`GridItem`	Restituisce l'elemento come elemento della griglia.
`asImageItem()`	`ImageItem`	Restituisce l'elemento come elemento immagine.
`asListItem()`	`ListItem`	Restituisce l'elemento come elemento dell'elenco.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Restituisce l'elemento come elemento a scelta multipla.
`asPageBreakItem()`	`PageBreakItem`	Restituisce l'elemento come interruzione di pagina.
`asParagraphTextItem()`	`ParagraphTextItem`	Restituisce l'elemento come elemento di testo paragrafo.
`asRatingItem()`	`RatingItem`	Restituisce l'elemento come elemento di valutazione.
`asScaleItem()`	`ScaleItem`	Restituisce l'elemento come elemento di scala.
`asSectionHeaderItem()`	`SectionHeaderItem`	Restituisce l'elemento come elemento di intestazione della sezione.
`asTextItem()`	`TextItem`	Restituisce l'elemento come elemento di testo.
`asTimeItem()`	`TimeItem`	Restituisce l'elemento come elemento di tempo.
`asVideoItem()`	`VideoItem`	Restituisce l'elemento come elemento video.
`duplicate()`	`Item`	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
`getHelpText()`	`String`	Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`getId()`	`Integer`	Recupera l'identificatore univoco dell'elemento.
`getIndex()`	`Integer`	Recupera l'indice dell'elemento tra tutti gli elementi del modulo.
`getTitle()`	`String`	Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un `SectionHeaderItem`).
`getType()`	`ItemType`	Recupera il tipo di elemento, rappresentato come `ItemType`.
`setHelpText(text)`	`Item`	Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setTitle(title)`	`Item`	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un `SectionHeaderItem`).

Documentazione dettagliata

`asCheckboxGridItem()`

Restituisce l'elemento come elemento della griglia di caselle di controllo. Viene lanciata un'eccezione di scripting se ItemType non era già CHECKBOX_GRID.

Invio

CheckboxGridItem: l'elemento della griglia con caselle di controllo

Lanci

Error: se l'elemento non è una casella di controllo della griglia

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asCheckboxItem()`

Restituisce l'elemento come elemento di casella di controllo. Viene lanciata un'eccezione di scripting se ItemType non era già CHECKBOX.

Invio

CheckboxItem: l'elemento della casella di controllo

Lanci

Error: se l'elemento non è una casella di controllo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asDateItem()`

Restituisce l'elemento come elemento data. Viene lanciata un'eccezione di scripting se ItemType non era già DATE.

Invio

DateItem: l'elemento data

Lanci

Error: se l'elemento non è una data

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asDateTimeItem()`

Restituisce l'elemento come elemento data/ora. Viene lanciata un'eccezione di scripting se ItemType non era già DATETIME.

Invio

DateTimeItem: l'elemento data/ora

Lanci

Error: se l'elemento non è una data e ora

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asDurationItem()`

Restituisce l'elemento come elemento di durata. Viene lanciata un'eccezione di scripting se ItemType non era già DURATION.

Invio

DurationItem: l'elemento della durata

Lanci

Error: se l'elemento non è un elemento di durata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asGridItem()`

Restituisce l'elemento come elemento della griglia. Viene lanciata un'eccezione di scripting se ItemType non era già GRID.

Invio

GridItem: l'elemento della griglia

Lanci

Error: se l'elemento non è un elemento della griglia

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asImageItem()`

Restituisce l'elemento come elemento immagine. Viene lanciata un'eccezione di scripting se ItemType non era già IMAGE.

Invio

ImageItem: l'elemento immagine

Lanci

Error: se l'elemento non è un'immagine

`asListItem()`

Restituisce l'elemento come elemento dell'elenco. Viene lanciata un'eccezione di scripting se ItemType non era già LIST.

Invio

ListItem: la voce dell'elenco

Lanci

Error: se l'elemento non è un elemento dell'elenco

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asMultipleChoiceItem()`

Restituisce l'elemento come elemento a scelta multipla. Viene lanciata un'eccezione di scripting se ItemType non era già MULTIPLE_CHOICE.

Invio

MultipleChoiceItem: l'elemento a scelta multipla

Lanci

Error: se l'elemento non è a scelta multipla

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asPageBreakItem()`

Restituisce l'elemento come interruzione di pagina. Viene lanciata un'eccezione di scripting se ItemType non era già PAGE_BREAK.

Invio

PageBreakItem: l'elemento di interruzione di pagina

Lanci

Error: se l'elemento non è un a capo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asParagraphTextItem()`

Restituisce l'elemento come elemento di testo paragrafo. Viene lanciata un'eccezione di scripting se ItemType non era già PARAGRAPH_TEXT.

Invio

ParagraphTextItem: l'elemento di testo del paragrafo

Lanci

Error: se l'elemento non è un elemento di testo del paragrafo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asRatingItem()`

Restituisce l'elemento come elemento di valutazione. Viene lanciata un'eccezione ScriptingException se ItemType non era già 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();

Invio

RatingItem: l'elemento di valutazione.

Lanci

Error: se l'elemento non è un elemento di valutazione

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asScaleItem()`

Restituisce l'elemento come elemento di scala. Viene lanciata un'eccezione di scripting se ItemType non era già SCALE.

Invio

ScaleItem: l'elemento della scala

Lanci

Error: se l'elemento non è una scala

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asSectionHeaderItem()`

Restituisce l'elemento come elemento di intestazione della sezione. Viene lanciata un'eccezione di scripting se ItemType non era già SECTION_HEADER.

Invio

SectionHeaderItem: l'elemento intestazione-sezione

Lanci

Error: se l'elemento non è un elemento di intestazione della sezione

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asTextItem()`

Restituisce l'elemento come elemento di testo. Viene lanciata un'eccezione di scripting se ItemType non era già TEXT.

Invio

TextItem: l'elemento di testo

Lanci

Error: se l'elemento non è un elemento di testo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asTimeItem()`

Restituisce l'elemento come elemento di tempo. Viene lanciata un'eccezione di scripting se ItemType non era già TIME.

Invio

TimeItem: l'elemento di tempo

Lanci

Error: se l'elemento non è un elemento di tempo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`asVideoItem()`

Restituisce l'elemento come elemento video. Viene lanciata un'eccezione di scripting se ItemType non era già VIDEO.

Invio

VideoItem: l'elemento video

Lanci

Error: se l'elemento non è un video

`duplicate()`

Crea una copia di questo elemento e la aggiunge alla fine del modulo.

Invio

Item: un duplicato di questo Item, per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getHelpText()`

Recupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Invio

String: il testo della guida o della descrizione dell'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getId()`

Recupera l'identificatore univoco dell'elemento.

Invio

Integer: l'ID dell'articolo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getIndex()`

Recupera l'indice dell'elemento tra tutti gli elementi del modulo.

Invio

Integer: l'indice dell'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getTitle()`

Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Invio

String: il titolo o il testo dell'intestazione dell'articolo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`getType()`

Recupera il tipo di elemento, rappresentato come ItemType.

Invio

ItemType: il tipo di articolo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setHelpText(text)`

Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

Nome	Tipo	Descrizione
`text`	`String`	il nuovo testo della guida

Invio

Item - questo Item, per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

`setTitle(title)`

Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Parametri

Nome	Tipo	Descrizione
`title`	`String`	il nuovo titolo o il nuovo testo dell'intestazione

Invio

Item - questo Item, per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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