Una domanda che consente al partecipante di scegliere un'opzione da una sequenza numerata di segnali radio
pulsanti. È possibile accedere o creare elementi da un Form. Quando vengono utilizzati in un quiz, questi elementi
vengono valutati.
// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
.setBounds(1, 10);
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
createResponse(response) | ItemResponse | Crea un nuovo ItemResponse per questo elemento della bilancia. |
duplicate() | ScaleItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getGeneralFeedback() | QuizFeedback | Restituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile. |
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. |
getLeftLabel() | String | Ottiene l'etichetta per il limite inferiore della bilancia, se presente. |
getLowerBound() | Integer | Restituisce il limite inferiore della scala. |
getPoints() | Integer | Restituisce il valore in punti di un elemento valutabile. |
getRightLabel() | String | Ottiene l'etichetta per il limite superiore della scala, se presente. |
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. |
getUpperBound() | Integer | Restituisce il limite superiore della scala. |
isRequired() | Boolean | Determina se l'intervistato deve rispondere alla domanda. |
setBounds(lower, upper) | ScaleItem | Imposta i limiti inferiore e superiore della bilancia. |
setGeneralFeedback(feedback) | ScaleItem | Imposta il feedback da mostrare agli intervistati quando rispondono a una domanda valutabile che Non ha una risposta corretta o errata (ovvero domande che richiedono una valutazione manuale). |
setHelpText(text) | ScaleItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
setLabels(lower, upper) | ScaleItem | Imposta le etichette per i limiti inferiore e superiore della bilancia. |
setPoints(points) | ScaleItem | Consente di impostare il numero di punti che un elemento valutabile merita. |
setRequired(enabled) | ScaleItem | Consente di impostare se l'intervistato deve rispondere alla domanda. |
setTitle(title) | ScaleItem | Imposta il titolo dell'elemento (a volte denominato testo dell'intestazione, nel caso di un SectionHeaderItem). |
Documentazione dettagliata
createResponse(response)
Crea un nuovo ItemResponse per questo elemento della bilancia. Genera un'eccezione se l'argomento response si trova al di fuori dei limiti impostati per l'elemento.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
response | Integer | una risposta al valore per questo elemento della scala |
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
ScaleItem: un duplicato di questa ScaleItem, 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
getGeneralFeedback()
Restituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile.
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
getLeftLabel()
Ottiene l'etichetta per il limite inferiore della bilancia, se presente.
Invio
String: l'etichetta del limite inferiore della bilancia
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
getLowerBound()
Restituisce il limite inferiore della scala.
Invio
Integer: il limite inferiore della bilancia
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
getRightLabel()
Ottiene l'etichetta per il limite superiore della scala, se presente.
Invio
String: l'etichetta del limite superiore della bilancia
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
getUpperBound()
Restituisce il limite superiore della scala.
Invio
Integer: il limite superiore della bilancia
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
setBounds(lower, upper)
Imposta i limiti inferiore e superiore della bilancia. Il limite inferiore deve essere 0 o 1. La
il limite superiore deve essere compreso tra 3 e 10 inclusi. Una nuova bilancia viene impostata automaticamente su
limite inferiore di 1 e un limite superiore di 5.
Genera un'eccezione di script se i valori specificati non rientrano nei limiti consentiti. Decimali vengono troncate al numero intero precedente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
lower | Integer | il nuovo limite inferiore |
upper | Integer | il nuovo limite superiore |
Invio
ScaleItem: ScaleItem, per concatenamento
Lanci
Error: se il limite inferiore o superiore non è valido
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
setGeneralFeedback(feedback)
Imposta il feedback da mostrare agli intervistati quando rispondono a una domanda valutabile che Non ha una risposta corretta o errata (ovvero domande che richiedono una valutazione manuale).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
feedback | QuizFeedback | il nuovo feedback |
Invio
ScaleItem: ScaleItem, 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
ScaleItem: ScaleItem, 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
setLabels(lower, upper)
Imposta le etichette per i limiti inferiore e superiore della bilancia.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
lower | String | la nuova etichetta per il limite inferiore |
upper | String | la nuova etichetta per il limite superiore |
Invio
ScaleItem: ScaleItem, 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
ScaleItem: ScaleItem, 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
ScaleItem: 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
ScaleItem: ScaleItem, 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