Class ListItem

ListItem

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

MetodoTipo restituitoBreve descrizione
createChoice(value)ChoiceCrea una nuova scelta.
createChoice(value, isCorrect)ChoiceCrea una nuova scelta.
createChoice(value, navigationItem)ChoiceCrea una nuova scelta con un'opzione di navigazione nelle pagine che rimanda 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 dell'elenco.
duplicate()ListItemCrea 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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerConsente di acquisire 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()StringConsente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
getType()ItemTypeRestituisce il tipo di elemento, rappresentato come ItemType.
isRequired()BooleanStabilisce se l'intervistato deve rispondere alla domanda.
setChoiceValues(values)ListItemConsente di impostare le scelte per un elemento da un array di stringhe.
setChoices(choices)ListItemConsente di impostare un array di opzioni per un elemento.
setFeedbackForCorrect(feedback)ListItemImposta il feedback da mostrare agli intervistati quando rispondono correttamente a una domanda.
setFeedbackForIncorrect(feedback)ListItemImposta il feedback da mostrare agli intervistati quando rispondono in modo errato a una domanda.
setHelpText(text)ListItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)ListItemImposta il numero di punti per il valore di un elemento valutabile.
setRequired(enabled)ListItemConsente di stabilire se l'intervistato deve rispondere alla domanda.
setTitle(title)ListItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).

Documentazione dettagliata

createChoice(value)

Crea una nuova scelta.

Parametri

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

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo
isCorrectBooleanse 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

NomeTipoDescrizione
valueStringil valore della scelta, che gli intervistati vedono come etichetta quando visualizzano il modulo
navigationItemPageBreakIteml'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

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

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

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

NomeTipoDescrizione
responseStringuna 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()

Recupera tutte le opzioni disponibili per un elemento.

Ritorni

Choice[]: una serie di opzioni

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.

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

NomeTipoDescrizione
valuesString[]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

NomeTipoDescrizione
choicesChoice[]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

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

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

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

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

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

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