Class MultipleChoiceItem

MultipleChoiceItem

Una domanda che consente al partecipante di selezionare un'opzione da un elenco di pulsanti di opzione o un'opzione "Altro" facoltativa . È possibile accedere o creare elementi da un Form. Quando utilizzata in quiz, questi elementi vengono valutati automaticamente. 

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

Metodi

MetodoTipo restituitoBreve descrizione
createChoice(value)ChoiceCrea una nuova scelta.
createChoice(value, isCorrect)ChoiceCrea una nuova scelta.
createChoice(value, navigationItem)ChoiceCrea una nuova opzione con un'opzione di navigazione nelle pagine per passare a un determinato elemento di interruzione di pagina.
createChoice(value, navigationType)ChoiceCrea una nuova scelta con un'opzione di navigazione nelle pagine.
createResponse(response)ItemResponseCrea un nuovo ItemResponse per questo elemento a scelta multipla.
duplicate()MultipleChoiceItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getChoices()Choice[]Recupera tutte le opzioni disponibili per un elemento.
getFeedbackForCorrect()QuizFeedbackRestituisce il feedback che viene mostrato agli intervistati quando rispondono correttamente a una domanda.
getFeedbackForIncorrect()QuizFeedbackRestituisce il feedback che viene mostrato agli intervistati quando rispondono in modo errato a una domanda.
getHelpText()StringRecupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRestituisce l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getTitle()StringRestituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRestituisce il tipo di elemento, rappresentato come ItemType.
hasOtherOption()BooleanDetermina se all'elemento è disponibile un'opzione "Altro" .
isRequired()BooleanDetermina se l'intervistato deve rispondere alla domanda.
setChoiceValues(values)MultipleChoiceItemImposta le scelte per un elemento da un array di stringhe.
setChoices(choices)MultipleChoiceItemConsente di impostare un array di scelte per un elemento.
setFeedbackForCorrect(feedback)MultipleChoiceItemImposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda.
setFeedbackForIncorrect(feedback)MultipleChoiceItemImposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda.
setHelpText(text)MultipleChoiceItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)MultipleChoiceItemConsente di impostare il numero di punti che un elemento valutabile merita.
setRequired(enabled)MultipleChoiceItemConsente di impostare se l'intervistato deve rispondere alla domanda.
setTitle(title)MultipleChoiceItemImposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem).
showOtherOption(enabled)MultipleChoiceItemImposta se l'elemento ha un "altro" .

Documentazione dettagliata

createChoice(value)

Crea una nuova scelta.

Parametri

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati 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

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo.
isCorrectBooleanse 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 opzione con un'opzione di navigazione nelle pagine per passare a un determinato elemento di interruzione di pagina. Questo equivale a createChoice(value, navigationType) con navigationType impostato su FormApp.PageNavigationType.GO_TO_PAGE. Scelte che utilizzano la pagina la navigazione non può essere combinata nello stesso elemento con opzioni che non utilizzano la navigazione nelle pagine.

La navigazione nelle pagine avviene dopo che l'intervistato completa una pagina che contiene l'opzione, e solo se l'intervistato ha scelto questa opzione. Se l'intervistato ha scelto più opzioni con istruzioni di navigazione nella stessa pagina, solo l'ultima opzione di navigazione avrà effetto. Inoltre, la navigazione nelle pagine non ha alcun effetto sull'ultima pagina di un modulo.

Parametri

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo.
navigationItemPageBreakIteml'elemento per andare

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

La navigazione nelle pagine avviene dopo che l'intervistato completa una pagina che contiene l'opzione, e solo se l'intervistato ha scelto questa opzione. Se l'intervistato ha scelto più opzioni con istruzioni di navigazione nella stessa pagina, solo l'ultima opzione di navigazione avrà effetto. Inoltre, la navigazione nelle pagine non ha alcun effetto sull'ultima pagina di un modulo.

Parametri

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo.
navigationTypePageNavigationTypeil tipo di navigazione

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

NomeTipoDescrizione
responseStringuna risposta valida per questo elemento a scelta multipla

Invio

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.

Invio

MultipleChoiceItem: un duplicato di questa MultipleChoiceItem, per il collegamento

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 disponibili per un elemento.

Invio

Choice[]: una serie 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 che viene mostrato agli intervistati 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 che viene mostrato agli intervistati quando rispondono in modo errato 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: testo della guida o testo descrittivo 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()

Restituisce l'identificatore univoco dell'elemento.

Invio

Integer: l'ID 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

getIndex()

Restituisce l'indice dell'elemento tra tutti gli elementi nel 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 che valgono per 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()

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

Invio

String: testo del titolo o 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()

Restituisce il tipo di elemento, rappresentato come ItemType.

Invio

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 all'elemento è disponibile un'opzione "Altro" .

Invio

Boolean: true se l'elemento ha un "altro" opzione; 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 l'intervistato deve rispondere alla domanda.

Invio

Boolean: se l'intervistato 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametri

NomeTipoDescrizione
valuesString[]l'array di valori di scelta, che gli intervistati vedono come etichette quando visualizzano il modulo

Invio

MultipleChoiceItem: MultipleChoiceItem, per 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)

Consente di impostare 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parametri

NomeTipoDescrizione
choicesChoice[]una serie di scelte

Invio

MultipleChoiceItem: MultipleChoiceItem, per concatenamento

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 agli intervistati quando rispondono correttamente a una domanda. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback. Se il valore è null, il feedback verrà cancellato.

Invio

MultipleChoiceItem: MultipleChoiceItem, per 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 agli intervistati quando rispondono in modo errato a una domanda.

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Invio

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

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Invio

MultipleChoiceItem: MultipleChoiceItem, per 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)

Consente di impostare il numero di punti che un elemento valutabile merita. Il valore predefinito per i nuovi elementi è 0.

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti su cui vale una domanda

Invio

MultipleChoiceItem: MultipleChoiceItem, per 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)

Consente di impostare se l'intervistato deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse l'intervistato deve rispondere alla domanda

Invio

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 denominato testo dell'intestazione, nel caso di un SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringIl nuovo titolo o il nuovo testo dell'intestazione

Invio

MultipleChoiceItem: MultipleChoiceItem, per 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 "altro" . L'impostazione predefinita per un nuovo CheckboxItem o MultipleChoiceItem è false.

Parametri

NomeTipoDescrizione
enabledBooleantrue se l'elemento ha un "altro" opzione; false in caso contrario

Invio

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