Un elemento di domanda che consente al partecipante di selezionare un'opzione da un elenco di pulsanti di opzione o da un campo "altro" facoltativo. È possibile accedere agli elementi o crearli da un Form. Quando vengono utilizzati in un quiz, gli 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
| 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 nelle pagine che rimanda a un determinato elemento di interruzione di pagina. |
createChoice(value, navigationType) | Choice | Crea una nuova scelta con un'opzione di navigazione nelle pagine. |
createResponse(response) | ItemResponse | Crea un nuovo ItemResponse per questo articolo a scelta multipla. |
duplicate() | MultipleChoiceItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getChoices() | Choice[] | Recupera tutte le opzioni disponibili per un elemento. |
getFeedbackForCorrect() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono correttamente a una domanda. |
getFeedbackForIncorrect() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono in modo errato a una domanda. |
getHelpText() | String | Recupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
getId() | Integer | Consente di acquisire l'identificatore univoco dell'elemento. |
getIndex() | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo. |
getPoints() | Integer | Restituisce il valore in punti di un elemento valutabile. |
getTitle() | String | Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType. |
hasOtherOption() | Boolean | Determina se l'elemento dispone di un'opzione di tipo "altro". |
isRequired() | Boolean | Stabilisce se l'intervistato deve rispondere alla domanda. |
setChoiceValues(values) | MultipleChoiceItem | Consente di impostare le scelte per un elemento da un array di stringhe. |
setChoices(choices) | MultipleChoiceItem | Consente di impostare un array di opzioni per un elemento. |
setFeedbackForCorrect(feedback) | MultipleChoiceItem | Imposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda. |
setFeedbackForIncorrect(feedback) | MultipleChoiceItem | Imposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda. |
setHelpText(text) | MultipleChoiceItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
setPoints(points) | MultipleChoiceItem | Imposta il numero di punti per il valore di un elemento valutabile. |
setRequired(enabled) | MultipleChoiceItem | Consente di stabilire se l'intervistato deve rispondere alla domanda. |
setTitle(title) | MultipleChoiceItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
showOtherOption(enabled) | MultipleChoiceItem | Consente di impostare 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 gli intervistati vedono come etichetta quando visualizzano il modulo |
Ritorni
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 gli intervistati vedono come etichetta quando visualizzano il modulo |
isCorrect | Boolean | se la risposta è corretta |
Ritorni
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 nelle pagine che rimanda a un determinato elemento di interruzione di pagina. Equivale a createChoice(value, navigationType) con navigationType impostato su FormApp.PageNavigationType.GO_TO_PAGE. Le scelte che utilizzano la navigazione nelle pagine non possono essere combinate nello stesso elemento con scelte che non utilizzano la navigazione nelle pagine.
La navigazione nelle pagine avviene dopo che l'intervistato completa una pagina contenente l'opzione e solo se l'intervistato ha scelto questa opzione. Se l'intervistato ha scelto più opzioni con istruzioni per la navigazione nelle pagine nella stessa pagina, solo l'ultima opzione avrà effetto. La navigazione nelle pagine non ha effetto neanche sull'ultima pagina di un modulo.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
value | String | il valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo |
navigationItem | PageBreakItem | l'elemento a cui accedere |
Ritorni
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 articolo 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 questo articolo a scelta multipla |
Ritorni
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.
Ritorni
MultipleChoiceItem: 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()
getFeedbackForCorrect()
Restituisce il feedback che viene mostrato agli intervistati quando rispondono correttamente a una domanda.
Ritorni
QuizFeedback: feedback, se disponibile.
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.
Ritorni
QuizFeedback: feedback, se disponibile.
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 descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Ritorni
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()
Consente di acquisire l'identificatore univoco dell'elemento.
Ritorni
Integer: 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 nel modulo.
Ritorni
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.
Ritorni
Integer: il numero di punti di 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()
Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
Ritorni
String: testo dell'intestazione o del titolo 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.
Ritorni
ItemType: 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 dispone di un'opzione di tipo "altro".
Ritorni
Boolean: true se l'elemento ha un'opzione di tipo "other"; in caso contrario false.
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()
Stabilisce se l'intervistato deve rispondere alla domanda.
Ritorni
Boolean: indica se la persona intervistata 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)
Consente di impostare 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
| Nome | Tipo | Descrizione |
|---|---|---|
values | String[] | l'array di valori di scelta, che gli intervistati vedono come etichette quando visualizzano il modulo |
Ritorni
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)
Consente di impostare 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.
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
| Nome | Tipo | Descrizione |
|---|---|---|
choices | Choice[] | una serie di opzioni |
Ritorni
MultipleChoiceItem: questo MultipleChoiceItem, per il concatenamento
Tiri
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
| Nome | Tipo | Descrizione |
|---|---|---|
feedback | QuizFeedback | il nuovo feedback. Se il valore è null, il feedback verrà cancellato. |
Ritorni
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 agli intervistati quando rispondono in modo errato a una domanda.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
feedback | QuizFeedback | il nuovo feedback |
Ritorni
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 della guida 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 |
Ritorni
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 per il valore di un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
points | Integer | il numero di punti di un elemento di domanda |
Ritorni
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)
Consente di stabilire se l'intervistato deve rispondere alla domanda.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
enabled | Boolean | se l'intervistato deve rispondere alla domanda |
Ritorni
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 SectionHeaderItem).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
title | String | il nuovo testo dell'intestazione o del titolo |
Ritorni
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)
Consente di impostare 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 di tipo "altro"; false in caso contrario |
Ritorni
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