Class MultipleChoiceItem

MultipleChoiceItem

Un elemento di domanda che consente a chi risponde di selezionare una scelta da un elenco di pulsanti di opzione o un campo "altro" facoltativo. È possibile accedere agli elementi o crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati automaticamente.

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

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 della pagina che rimanda a un determinato elemento di interruzione di pagina.
createChoice(value, navigationType)	Choice	Crea una nuova scelta con un'opzione di navigazione della pagina.
createResponse(response)	ItemResponse	Crea un nuovo ItemResponse per questa domanda a scelta multipla.
duplicate()	MultipleChoiceItem	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
getChoices()	Choice[]	Recupera tutte le scelte per un elemento.
getFeedbackForCorrect()	QuizFeedback|null	Restituisce il feedback mostrato ai partecipanti quando rispondono correttamente a una domanda.
getFeedbackForIncorrect()	QuizFeedback|null	Restituisce il feedback mostrato ai rispondenti quando rispondono in modo errato a una domanda.
getHelpText()	String	Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()	Integer	Recupera l'identificatore univoco dell'elemento.
getIndex()	Integer	Restituisce 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 dell'elemento, rappresentato come ItemType.
hasOtherOption()	Boolean	Determina se l'elemento ha un'opzione "altro".
isRequired()	Boolean	Determina se chi risponde deve rispondere alla domanda.
setChoiceValues(values)	MultipleChoiceItem	Imposta le scelte per un elemento da un array di stringhe.
setChoices(choices)	MultipleChoiceItem	Imposta un array di scelte per un elemento.
setFeedbackForCorrect(feedback)	MultipleChoiceItem	Imposta il feedback da mostrare ai partecipanti quando rispondono correttamente a una domanda.
setFeedbackForIncorrect(feedback)	MultipleChoiceItem	Imposta il feedback da mostrare ai rispondenti quando rispondono in modo errato a una domanda.
setHelpText(text)	MultipleChoiceItem	Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)	MultipleChoiceItem	Imposta il numero di punti che vale un elemento valutabile.
setRequired(enabled)	MultipleChoiceItem	Determina se il rispondente deve rispondere alla domanda.
setTitle(title)	MultipleChoiceItem	Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
showOtherOption(enabled)	MultipleChoiceItem	Imposta se l'elemento ha un'opzione "altro".

Documentazione dettagliata

createChoice(value)

Crea una nuova scelta.

Parametri

Nome	Tipo	Descrizione
value	String	Il valore della scelta, che chi risponde vede come etichetta quando visualizza il modulo.

Indietro

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 chi risponde vede come etichetta quando visualizza il modulo.
isCorrect	Boolean	se la scelta è una risposta corretta

Indietro

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 della pagina che rimanda a un determinato elemento di interruzione di pagina. Questo è equivalente a createChoice(value, navigationType) con navigationType impostato su FormApp.PageNavigationType.GO_TO_PAGE. Le scelte che utilizzano la navigazione delle pagine non possono essere combinate nello stesso elemento con le scelte che non la utilizzano.

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

Tieni presente che l'utilizzo della navigazione nelle pagine di un elemento codifica l'instradamento, il che significa che showOtherOption(true) non deve essere utilizzato contemporaneamente.

Parametri

Nome	Tipo	Descrizione
value	String	Il valore della scelta, che chi risponde vede come etichetta quando visualizza il modulo.
navigationItem	PageBreakItem	l'elemento a cui passare

Indietro

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 della pagina. Le scelte che utilizzano la navigazione nelle pagine non possono essere combinate nello stesso elemento con le scelte che non la utilizzano.

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

Tieni presente che l'utilizzo della navigazione nelle pagine di un elemento codifica l'instradamento, il che significa che showOtherOption(true) non deve essere utilizzato contemporaneamente.

Parametri

Nome	Tipo	Descrizione
value	String	Il valore della scelta, che chi risponde vede come etichetta quando visualizza il modulo.
navigationType	PageNavigationType	il tipo di navigazione della scelta

Indietro

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 questa domanda a scelta multipla. Genera un'eccezione se l'argomento response non corrisponde a una scelta valida per questo elemento, a meno che showOtherOption(enabled) non sia impostato su true.

Parametri

Nome	Tipo	Descrizione
response	String	una risposta valida per questa domanda a scelta multipla

Indietro

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

Indietro

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

---

getChoices()

Recupera tutte le scelte per un elemento.

Indietro

Choice[]: una gamma di scelte

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.

Indietro

QuizFeedback|null: 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 rispondenti quando rispondono in modo errato a una domanda.

Indietro

QuizFeedback|null: 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 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

---

getPoints()

Restituisce il valore in punti di un elemento valutabile.

Indietro

Integer: il numero di punti che vale 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).

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

---

hasOtherOption()

Determina se l'elemento ha un'opzione "altro".

Indietro

Boolean - true se l'elemento ha un'opzione "altro"; false in caso contrario

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 chi risponde deve rispondere alla domanda.

Indietro

Boolean: indica se chi risponde 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 scelte 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 vedono come etichette quando visualizzano il modulo

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

setChoices(choices)

Imposta un array di scelte 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[]	una serie di scelte

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, per il concatenamento

Genera

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().setText('Dogs rule, cats drool.').build(),
);

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback. Un valore nullo cancellerà il feedback.

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

setFeedbackForIncorrect(feedback)

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

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

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

Nome	Tipo	Descrizione
text	String	il nuovo testo della guida

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

setPoints(points)

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

Parametri

Nome	Tipo	Descrizione
points	Integer	il numero di punti che vale una domanda

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

setRequired(enabled)

Determina se il rispondente deve rispondere alla domanda.

Parametri

Nome	Tipo	Descrizione
enabled	Boolean	se chi risponde deve rispondere alla domanda

Indietro

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

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

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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

---

showOtherOption(enabled)

Imposta se l'elemento ha un'opzione "altro". Il valore predefinito per un nuovo CheckboxItem o MultipleChoiceItem è false.

Parametri

Nome	Tipo	Descrizione
enabled	Boolean	true se l'elemento ha un'opzione "altro"; false in caso contrario

Indietro

MultipleChoiceItem: questo MultipleChoiceItem, 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