Interface Item

Elemento

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

Per operare su proprietà specifiche del tipo, utilizza getType() per controllare ItemType dell'elemento, quindi esegui il cast dell'elemento nella 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 delle classi

NomeBreve descrizione

Metodi

MetodoTipo restituitoBreve descrizione
asCheckboxGridItem()CheckboxGridItemRestituisce l'elemento come elemento della griglia di caselle di controllo.
asCheckboxItem()CheckboxItemRestituisce l'elemento come elemento della casella di controllo.
asDateItem()DateItemRestituisce l'elemento come elemento di data.
asDateTimeItem()DateTimeItemRestituisce l'elemento come elemento data/ora.
asDurationItem()DurationItemRestituisce l'elemento come elemento di durata.
asGridItem()GridItemRestituisce l'elemento come elemento della griglia.
asImageItem()ImageItemRestituisce l'elemento come elemento immagine.
asListItem()ListItemRestituisce l'elemento come elemento di elenco.
asMultipleChoiceItem()MultipleChoiceItemRestituisce l'elemento come elemento a scelta multipla.
asPageBreakItem()PageBreakItemRestituisce l'elemento come elemento di interruzione di pagina.
asParagraphTextItem()ParagraphTextItemRestituisce l'elemento come elemento di testo del paragrafo.
asRatingItem()RatingItemRestituisce l'elemento come elemento di valutazione.
asScaleItem()ScaleItemRestituisce l'elemento come elemento di scala.
asSectionHeaderItem()SectionHeaderItemRestituisce l'elemento come elemento di intestazione di sezione.
asTextItem()TextItemRestituisce l'elemento come elemento di testo.
asTimeItem()TimeItemRestituisce l'elemento come elemento temporale.
asVideoItem()VideoItemRestituisce l'elemento come elemento video.
duplicate()ItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRecupera il tipo dell'elemento, rappresentato come ItemType.
setHelpText(text)ItemImposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setTitle(title)ItemImposta 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. Genera un'eccezione di scripting se ItemType non è già CHECKBOX_GRID.

Indietro

CheckboxGridItem: l'elemento della griglia con caselle di controllo

Genera

Error: se l'elemento non è una griglia di caselle 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

asCheckboxItem()

Restituisce l'elemento come elemento della casella di controllo. Genera un'eccezione di scripting se ItemType non è già CHECKBOX.

Indietro

CheckboxItem: la voce della casella di controllo

Genera

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 di data. Genera un'eccezione di scripting se ItemType non è già DATE.

Indietro

DateItem: l'elemento data

Genera

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. Genera un'eccezione di scripting se ItemType non è già DATETIME.

Indietro

DateTimeItem: l'elemento data/ora

Genera

Error: se l'elemento non è un elemento data/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. Genera un'eccezione di scripting se ItemType non è già DURATION.

Indietro

DurationItem: l'elemento di durata

Genera

Error: se l'articolo non è un articolo a 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. Genera un'eccezione di scripting se ItemType non è già GRID.

Indietro

GridItem: l'elemento della griglia

Genera

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. Genera un'eccezione di scripting se ItemType non è già IMAGE.

Indietro

ImageItem: l'elemento immagine

Genera

Error: se l'elemento non è un elemento immagine

asListItem()

Restituisce l'elemento come elemento di elenco. Genera un'eccezione di scripting se ItemType non è già LIST.

Indietro

ListItem: la voce di elenco

Genera

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. Genera un'eccezione di scripting se ItemType non è già MULTIPLE_CHOICE.

Indietro

MultipleChoiceItem: l'elemento a scelta multipla

Genera

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 elemento di interruzione di pagina. Genera un'eccezione di scripting se ItemType non è già PAGE_BREAK.

Indietro

PageBreakItem: l'elemento interruzione di pagina

Genera

Error: se l'elemento non è un elemento di interruzione di pagina

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 del paragrafo. Genera un'eccezione di scripting se ItemType non è già PARAGRAPH_TEXT.

Indietro

ParagraphTextItem: l'elemento di testo del paragrafo

Genera

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. Genera un'eccezione ScriptingException se ItemType non è 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();

Indietro

RatingItem: l'elemento di valutazione.

Genera

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. Genera un'eccezione di scripting se ItemType non è già SCALE.

Indietro

ScaleItem: l'elemento della scala

Genera

Error: se l'elemento non è un elemento della 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 di sezione. Genera un'eccezione di scripting se ItemType non è già SECTION_HEADER.

Indietro

SectionHeaderItem: l'elemento intestazione di sezione

Genera

Error: se l'elemento non è un'intestazione di 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. Genera un'eccezione di scripting se ItemType non è già TEXT.

Indietro

TextItem: l'elemento di testo

Genera

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 temporale. Genera un'eccezione di scripting se ItemType non è già TIME.

Indietro

TimeItem: l'elemento di tempo

Genera

Error: se l'articolo non è un articolo a 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. Genera un'eccezione di scripting se ItemType non è già VIDEO.

Indietro

VideoItem: l'elemento video

Genera

Error: se l'elemento non è un video

duplicate()

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

Indietro

Item: un duplicato di questo Item, per il concatenamento

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 della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Indietro

String: il testo della guida o la 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.

Indietro

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()

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

Indietro

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

Indietro

String: il titolo o il testo dell'intestazione 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

getType()

Recupera il tipo dell'elemento, rappresentato come ItemType.

Indietro

ItemType: il tipo di 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

setHelpText(text)

Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Indietro

Item: questo Item, per il concatenamento

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

NomeTipoDescrizione
titleStringil nuovo testo del titolo o dell'intestazione

Indietro

Item: questo Item, per il concatenamento

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