Class ListItem

ListItem

Un elemento di domanda che consente al rispondente di selezionare una scelta da un elenco a discesa. È possibile accedere agli elementi o crearli da un Form.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

Metodi

Metodo	Tipo restituito	Breve descrizione
createChoice(value)	Choice	Crea una nuova scelta.
createChoice(value, isCorrect)	Choice	Crea una nuova scelta.
createChoice(value, navigationItem)	Choice	Crea una nuova scelta con un'opzione di navigazione tra le pagine che passa a un determinato elemento di interruzione di pagina.
createChoice(value, navigationType)	Choice	Crea una nuova scelta con un'opzione di navigazione nella pagina.
createResponse(response)	ItemResponse	Crea un nuovo ItemResponse per questo elemento dell'elenco.
duplicate()	ListItem	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
getChoices()	Choice[]	Recupera tutte le opzioni per un elemento.
getFeedbackForCorrect()	QuizFeedback	Restituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.
getFeedbackForIncorrect()	QuizFeedback	Restituisce il feedback mostrato ai partecipanti quando rispondono erroneamente a una domanda.
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.
getPoints()	Integer	Restituisce il valore in punti di un elemento valutabile.
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.
isRequired()	Boolean	Determina se il rispondente deve rispondere alla domanda.
setChoiceValues(values)	ListItem	Imposta le opzioni per un elemento da un array di stringhe.
setChoices(choices)	ListItem	Imposta un array di opzioni per un elemento.
setFeedbackForCorrect(feedback)	ListItem	Imposta il feedback da mostrare ai partecipanti quando rispondono correttamente a una domanda.
setFeedbackForIncorrect(feedback)	ListItem	Imposta il feedback da mostrare ai partecipanti quando rispondono in modo errato a una domanda.
setHelpText(text)	ListItem	Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)	ListItem	Imposta il numero di punti attribuiti a un elemento valutabile.
setRequired(enabled)	ListItem	Imposta se il rispondente deve rispondere alla domanda.
setTitle(title)	ListItem	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Documentazione dettagliata

createChoice(value)

Crea una nuova scelta.

Parametri

Nome	Tipo	Descrizione
value	String	il valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo

Invio

Choice: la nuova scelta

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

---

createChoice(value, isCorrect)

Crea una nuova scelta.

Parametri

Nome	Tipo	Descrizione
value	String	il valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo
isCorrect	Boolean	se la scelta è una risposta corretta

Invio

Choice: la nuova scelta

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

---

createChoice(value, navigationItem)

Crea una nuova scelta con un'opzione di navigazione tra le pagine che passa a un determinato elemento di interruzione di pagina. Questo è equivalente a createChoice(value, navigationType) con navigationType impostato su FormApp.PageNavigationType.GO_TO_PAGE. Le opzioni che utilizzano la navigazione nelle pagine non possono essere combinate nello stesso elemento con le opzioni che non la utilizzano.

La navigazione nella pagina avviene dopo che il rispondente ha completato una pagina contenente l'opzione e solo se il rispondente ha scelto l'opzione. Se il rispondente ha scelto più opzioni con istruzioni di navigazione nella stessa pagina, ha effetto solo l'ultima opzione di navigazione. La navigazione tra le pagine non ha alcun effetto neanche sull'ultima pagina di un modulo.

Parametri

Nome	Tipo	Descrizione
value	String	il valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo
navigationItem	PageBreakItem	l'elemento a cui passare

Invio

Choice: la nuova scelta

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

---

createChoice(value, navigationType)

Crea una nuova scelta con un'opzione di navigazione nella pagina. Le opzioni che utilizzano la navigazione nelle pagine non possono essere combinate nello stesso elemento con le opzioni che non la utilizzano.

La navigazione nella pagina avviene dopo che il rispondente ha completato una pagina contenente l'opzione e solo se il rispondente ha scelto l'opzione. Se il rispondente ha scelto più opzioni con istruzioni di navigazione nella stessa pagina, ha effetto solo l'ultima opzione di navigazione. La navigazione tra le pagine non ha alcun effetto neanche sull'ultima pagina di un modulo.

Parametri

Nome	Tipo	Descrizione
value	String	il valore della scelta, che i rispondenti vedono come etichetta quando visualizzano il modulo
navigationType	PageNavigationType	il tipo di navigazione della scelta

Invio

Choice: la nuova scelta

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

---

createResponse(response)

Crea un nuovo ItemResponse per questo elemento dell'elenco. Viene lanciata un'eccezione se l'argomento response non corrisponde a una scelta valida per questo elemento.

Parametri

Nome	Tipo	Descrizione
response	String	una risposta valida per questo elemento dell'elenco

Invio

ItemResponse: la risposta 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

---

duplicate()

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

Invio

ListItem: un duplicato di questo ListItem, 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

---

getChoices()

Recupera tutte le opzioni per un elemento.

Invio

Choice[]: un array di opzioni

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

---

getFeedbackForCorrect()

Restituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.

Invio

QuizFeedback: il feedback, se presente.

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

---

getFeedbackForIncorrect()

Restituisce il feedback mostrato ai partecipanti quando rispondono erroneamente a una domanda.

Invio

QuizFeedback: il feedback, se presente.

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

---

getPoints()

Restituisce il valore in punti di un elemento valutabile.

Invio

Integer: il numero di punti assegnati a una domanda.

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

---

isRequired()

Determina se il rispondente deve rispondere alla domanda.

Invio

Boolean: indica se il rispondente deve rispondere alla domanda

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

---

setChoiceValues(values)

Imposta le opzioni per un elemento da un array di stringhe. Genera un'eccezione se l'array specificato è vuoto.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametri

Nome	Tipo	Descrizione
values	String[]	l'array di valori di scelta, che gli utenti che rispondono al modulo vedono come etichette quando visualizzano il modulo

Invio

ListItem - questo ListItem, 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

---

setChoices(choices)

Imposta un array di opzioni per un elemento. Genera un'eccezione se l'array specificato è vuoto o contiene un elemento null.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

Parametri

Nome	Tipo	Descrizione
choices	Choice[]	un array di opzioni

Invio

ListItem - questo ListItem, per l'accodamento

Lanci

Error: se l'array specificato è null, vuoto o contiene un elemento null

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

---

setFeedbackForCorrect(feedback)

Imposta il feedback da mostrare ai partecipanti quando rispondono correttamente a una domanda.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback. Un valore nullo cancella il feedback.

Invio

ListItem - questo ListItem, 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

---

setFeedbackForIncorrect(feedback)

Imposta il feedback da mostrare ai partecipanti quando rispondono in modo errato a una domanda.

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback

Invio

ListItem - questo ListItem, 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

---

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

ListItem - questo ListItem, 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

---

setPoints(points)

Imposta il numero di punti attribuiti a un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

Nome	Tipo	Descrizione
points	Integer	il numero di punti che vale un elemento della domanda

Invio

ListItem - questo ListItem, 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

---

setRequired(enabled)

Imposta se il rispondente deve rispondere alla domanda.

Parametri

Nome	Tipo	Descrizione
enabled	Boolean	se il rispondente deve rispondere alla domanda

Invio

ListItem: l'elemento corrente (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

ListItem - questo ListItem, 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