Class RatingItem

RatingItem

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

Metodi

MetodoTipo restituitoBreve descrizione
createResponse(response)ItemResponseCrea un nuovo ItemResponse per questo elemento di classificazione.
duplicate()RatingItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()QuizFeedbackRestituisce il feedback mostrato ai partecipanti quando rispondono a una domanda con voto.
getHelpText()StringRecupera il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRecupera l'indice dell'elemento tra tutti gli elementi del modulo.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getRatingIcon()RatingIconTypeRecupera l'icona scelta per la classificazione.
getRatingScaleLevel()IntegerRecupera il livello della scala di valutazione.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRecupera il tipo di elemento, rappresentato come ItemType.
isRequired()BooleanDetermina se il rispondente deve rispondere alla domanda.
setGeneralFeedback(feedback)RatingItemImposta il feedback da mostrare ai partecipanti quando rispondono a una domanda valutabile che non ha una risposta corretta o sbagliata (ad es. domande che richiedono la valutazione manuale).
setHelpText(text)RatingItemImposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)RatingItemImposta il numero di punti attribuiti a un elemento valutabile.
setRatingIcon(ratingIcon)RatingItemImposta l'icona della classificazione.
setRatingScaleLevel(ratingScaleLevel)RatingItemImposta il livello della scala di valutazione.
setRequired(enabled)RatingItemImposta se il rispondente deve rispondere alla domanda.
setTitle(title)RatingItemImposta 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 di classificazione.

Genera un'eccezione di scripting se il valore response fornito è inferiore a 1 o superiore al valore restituito da getRatingScaleLevel(). 

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a new response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

Parametri

NomeTipoDescrizione
responseIntegerUna risposta con valore per questo elemento di valutazione.

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

RatingItem: un duplicato di questo RatingItem, per l'accodamento

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 partecipanti quando rispondono a una domanda con voto.

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: il testo della guida o della 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.

Invio

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

Recupera l'indice dell'elemento tra tutti gli elementi del 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

getPoints()

Restituisce il valore in punti di un elemento valutabile.

Invio

Integer: il numero di punti assegnati a 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

getRatingIcon()

Recupera l'icona scelta per la classificazione. 

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

Invio

RatingIconType: il tipo di icona di classificazione.

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

getRatingScaleLevel()

Recupera il livello della scala di valutazione. 

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

Invio

Integer: il livello della scala di valutazione.

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

Invio

String: il titolo o il testo dell'intestazione 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

getType()

Recupera il tipo di elemento, rappresentato come ItemType.

Invio

ItemType: il tipo di 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

isRequired()

Determina se il rispondente deve rispondere alla domanda.

Invio

Boolean: indica se il rispondente 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

setGeneralFeedback(feedback)

Imposta il feedback da mostrare ai partecipanti quando rispondono a una domanda valutabile che non ha una risposta corretta o sbagliata (ad es. domande che richiedono la valutazione manuale).

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Invio

RatingItem - questo RatingItem, per l'accodamento

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

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Invio

RatingItem - questo RatingItem, per l'accodamento

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

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti che vale un elemento della domanda

Invio

RatingItem - questo RatingItem, per l'accodamento

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

setRatingIcon(ratingIcon)

Imposta l'icona della classificazione.

Viene lanciata un'eccezione di scripting se il tipo di icona della classificazione non è valido. 

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

Parametri

NomeTipoDescrizione
ratingIconRatingIconTypeIl tipo di icona di classificazione.

Invio

RatingItem: questo RatingItem, per l'accodamento.

Lanci

Error: se il tipo di icona di valutazione 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

setRatingScaleLevel(ratingScaleLevel)

Imposta il livello della scala di valutazione. Il livello della scala di valutazione deve essere compreso tra 3 e 10, inclusi. Per una nuova valutazione viene utilizzato per impostazione predefinita il livello 3 della scala di valutazione.

Genera un'eccezione di scripting se i valori specificati non rientrano nei limiti consentiti. 

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

Parametri

NomeTipoDescrizione
ratingScaleLevelIntegerIl livello della scala di valutazione.

Invio

RatingItem: questo RatingItem, per l'accodamento.

Lanci

Error: se il livello della scala di valutazione 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

setRequired(enabled)

Imposta se il rispondente deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse il rispondente deve rispondere alla domanda

Invio

RatingItem: l'elemento corrente (per l'accodamento)

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 titolo o il nuovo testo dell'intestazione

Invio

RatingItem - questo RatingItem, per l'accodamento

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