Un elemento di domanda che consente al partecipante di selezionare un'opzione 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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 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 elemento dell'elenco. |
duplicate() | ListItem | 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 . |
isRequired() | Boolean | Stabilisce se l'intervistato deve rispondere alla domanda. |
setChoiceValues(values) | ListItem | Consente di impostare le scelte per un elemento da un array di stringhe. |
setChoices(choices) | ListItem | Consente di impostare un array di opzioni per un elemento. |
setFeedbackForCorrect(feedback) | ListItem | Imposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda. |
setFeedbackForIncorrect(feedback) | ListItem | Imposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda. |
setHelpText(text) | ListItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems , PageBreakItems e SectionHeaderItems ). |
setPoints(points) | ListItem | Imposta il numero di punti per il valore di un elemento valutabile. |
setRequired(enabled) | ListItem | Consente di stabilire se l'intervistato deve rispondere alla domanda. |
setTitle(title) | ListItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem ). |
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 elemento dell'elenco. Genera 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 |
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
ListItem
: duplicato di questo ListItem
, 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
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
ListItem
: questo ListItem
, 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
ListItem
: questo ListItem
, 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
ListItem
: questo ListItem
, 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
ListItem
: questo ListItem
, 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
ListItem
: questo ListItem
, 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
ListItem
: questo ListItem
, 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
ListItem
: 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
ListItem
: questo ListItem
, 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