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
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 opzione con un'opzione di navigazione nelle pagine per passare 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 elemento 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 di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
getId() | Integer | Restituisce 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 | Restituisce il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType . |
hasOtherOption() | Boolean | Determina se all'elemento è disponibile un'opzione "Altro" . |
isRequired() | Boolean | Determina se l'intervistato deve rispondere alla domanda. |
setChoiceValues(values) | MultipleChoiceItem | Imposta le scelte per un elemento da un array di stringhe. |
setChoices(choices) | MultipleChoiceItem | Consente di impostare un array di scelte 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 | Consente di impostare il numero di punti che un elemento valutabile merita. |
setRequired(enabled) | MultipleChoiceItem | Consente di impostare se l'intervistato deve rispondere alla domanda. |
setTitle(title) | MultipleChoiceItem | Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem ). |
showOtherOption(enabled) | MultipleChoiceItem | Imposta se l'elemento ha un "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. |
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 gli intervistati 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 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
Nome | Tipo | Descrizione |
---|---|---|
value | String | il valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo. |
navigationItem | PageBreakItem | l'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
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
Nome | Tipo | Descrizione |
---|---|---|
response | String | una 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()
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
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | 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
Nome | Tipo | Descrizione |
---|---|---|
choices | Choice[] | 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
Nome | Tipo | Descrizione |
---|---|---|
feedback | QuizFeedback | il 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
Nome | Tipo | Descrizione |
---|---|---|
feedback | QuizFeedback | il 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
Nome | Tipo | Descrizione |
---|---|---|
text | String | il 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
Nome | Tipo | Descrizione |
---|---|---|
points | Integer | il 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
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | se 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
Nome | Tipo | Descrizione |
---|---|---|
title | String | Il 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
Nome | Tipo | Descrizione |
---|---|---|
enabled | Boolean | true 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