Class ScaleItem

ScaleItem

Un elemento di domanda che consente al partecipante di scegliere un'opzione da una sequenza numerata di pulsanti di opzione. È possibile accedere agli elementi o crearli 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

MetodoTipo restituitoBreve descrizione
createResponse(response)ItemResponseCrea un nuovo ItemResponse per questo elemento della bilancia.
duplicate()ScaleItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()QuizFeedbackRestituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile.
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.
getLeftLabel()StringRestituisce l'etichetta dell'eventuale limite inferiore della bilancia.
getLowerBound()IntegerRestituisce il limite inferiore della bilancia.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getRightLabel()StringConsente di acquisire l'etichetta dell'eventuale limite superiore della bilancia.
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.
getUpperBound()IntegerRestituisce il limite superiore della bilancia.
isRequired()BooleanStabilisce se l'intervistato deve rispondere alla domanda.
setBounds(lower, upper)ScaleItemImposta i limiti inferiore e superiore della bilancia.
setGeneralFeedback(feedback)ScaleItemImposta il feedback da mostrare agli intervistati quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ovvero domande che richiedono la valutazione manuale).
setHelpText(text)ScaleItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setLabels(lower, upper)ScaleItemImposta le etichette per i limiti inferiore e superiore della scala.
setPoints(points)ScaleItemImposta il numero di punti per il valore di un elemento valutabile.
setRequired(enabled)ScaleItemConsente di stabilire se l'intervistato deve rispondere alla domanda.
setTitle(title)ScaleItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).

Documentazione dettagliata

createResponse(response)

Crea un nuovo ItemResponse per questo elemento della bilancia. Genera un'eccezione se l'argomento response non rientra nei limiti impostati per l'elemento.

Parametri

NomeTipoDescrizione
responseIntegeruna risposta di valore per questo elemento della scala

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

ScaleItem: duplicato di questo ScaleItem, 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

getGeneralFeedback()

Restituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile.

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

getLeftLabel()

Restituisce l'etichetta dell'eventuale limite inferiore della bilancia.

Ritorni

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

Ritorni

Integer: 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.

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

getRightLabel()

Consente di acquisire l'etichetta dell'eventuale limite superiore della bilancia.

Ritorni

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

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

getUpperBound()

Restituisce il limite superiore della bilancia.

Ritorni

Integer: 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()

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

setBounds(lower, upper)

Imposta i limiti inferiore e superiore della bilancia. Il limite inferiore deve essere 0 o 1. Il limite superiore deve essere compreso tra 3 e 10 inclusi. Per impostazione predefinita, un nuovo limite inferiore è pari a 1 e un limite superiore pari a 5.

Genera un'eccezione di scripting se i valori specificati non rientrano nei limiti consentiti. I decimali vengono troncati al numero intero precedente.

Parametri

NomeTipoDescrizione
lowerIntegeril nuovo limite inferiore
upperIntegeril nuovo limite superiore

Ritorni

ScaleItem: questo ScaleItem, per il concatenamento

Tiri

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 la valutazione manuale).

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Ritorni

ScaleItem: questo ScaleItem, 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

ScaleItem: questo ScaleItem, 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

setLabels(lower, upper)

Imposta le etichette per i limiti inferiore e superiore della scala.

Parametri

NomeTipoDescrizione
lowerStringla nuova etichetta per il limite inferiore
upperStringla nuova etichetta per il limite superiore

Ritorni

ScaleItem: questo ScaleItem, 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

ScaleItem: questo ScaleItem, 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

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 chiamato testo dell'intestazione, nel caso di SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo testo dell'intestazione o del titolo

Ritorni

ScaleItem: questo ScaleItem, 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