Class ScaleItem

ScaleItem

Un elemento della domanda che consente all'intervistato di scegliere un'opzione da una sequenza numerata di pulsanti di opzione. È possibile accedere agli elementi o crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati. 

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 scala.
duplicate()ScaleItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()QuizFeedback|nullRestituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getLeftLabel()StringRestituisce l'etichetta per il limite inferiore della scala, se presente.
getLowerBound()IntegerRestituisce il limite inferiore della scala.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getRightLabel()StringRestituisce l'etichetta per il limite superiore della scala, se presente.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRecupera il tipo dell'elemento, rappresentato come ItemType.
getUpperBound()IntegerRestituisce il limite superiore della scala.
isRequired()BooleanDetermina se chi risponde deve rispondere alla domanda.
setBounds(lower, upper)ScaleItemImposta i limiti inferiore e superiore della scala.
setGeneralFeedback(feedback)ScaleItemImposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad es. domande che richiedono una valutazione manuale).
setHelpText(text)ScaleItemImposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli 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 che vale un elemento valutabile.
setRequired(enabled)ScaleItemDetermina se il rispondente deve rispondere alla domanda.
setTitle(title)ScaleItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Documentazione dettagliata

createResponse(response)

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

Parametri

NomeTipoDescrizione
responseIntegerun valore di risposta per questo elemento della scala

Indietro

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.

Indietro

ScaleItem: un 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 mostrato ai rispondenti quando rispondono a una domanda valutabile.

Indietro

QuizFeedback|null: 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 della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Indietro

String: il testo della guida o la descrizione 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()

Recupera l'identificatore univoco dell'elemento.

Indietro

Integer: l'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 del modulo.

Indietro

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 per il limite inferiore della scala, se presente.

Indietro

String: l'etichetta per il limite inferiore della scala

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.

Indietro

Integer: il limite inferiore della scala

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.

Indietro

Integer: il numero di punti che vale 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()

Restituisce l'etichetta per il limite superiore della scala, se presente.

Indietro

String: l'etichetta per il limite superiore della scala

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

Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Indietro

String: il titolo o il testo 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()

Recupera il tipo dell'elemento, rappresentato come ItemType.

Indietro

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.

Indietro

Integer: il limite superiore della scala

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 chi risponde deve rispondere alla domanda.

Indietro

Boolean: indica se chi risponde 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 scala. Il limite inferiore deve essere 0 o 1. Il limite superiore deve essere compreso tra 3 e 10 inclusi. Una nuova scala ha per impostazione predefinita un limite inferiore di 1 e un limite superiore di 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

Indietro

ScaleItem: questo ScaleItem, per il concatenamento

Genera

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 ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad es. domande che richiedono una valutazione manuale).

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Indietro

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 di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Indietro

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

Indietro

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 che vale un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti che vale una domanda

Indietro

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)

Determina se il rispondente deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse chi risponde deve rispondere alla domanda

Indietro

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 un SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo testo del titolo o dell'intestazione

Indietro

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