Questa pagina è stata tradotta dall'API Cloud Translation.

Class ScaleItem

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