Class RatingItem

ElementoValutazione

Un elemento domanda che consente all'intervistato di fornire 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

Metodo	Tipo restituito	Breve descrizione
createResponse(response)	ItemResponse	Crea un nuovo ItemResponse per questo elemento di valutazione.
duplicate()	RatingItem	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()	QuizFeedback	Restituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile.
getHelpText()	String	Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()	Integer	Recupera l'identificatore univoco dell'elemento.
getIndex()	Integer	Restituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getPoints()	Integer	Restituisce il valore in punti di un elemento valutabile.
getRatingIcon()	RatingIconType	Recupera l'icona scelta per la valutazione.
getRatingScaleLevel()	Integer	Restituisce il livello della scala di valutazione.
getTitle()	String	Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()	ItemType	Restituisce il tipo dell'elemento, rappresentato come ItemType.
isRequired()	Boolean	Determina se il rispondente deve rispondere alla domanda.
setGeneralFeedback(feedback)	RatingItem	Imposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad esempio, le domande che richiedono una valutazione manuale).
setHelpText(text)	RatingItem	Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setPoints(points)	RatingItem	Imposta il numero di punti che vale un elemento valutabile.
setRatingIcon(ratingIcon)	RatingItem	Imposta l'icona della valutazione.
setRatingScaleLevel(ratingScaleLevel)	RatingItem	Imposta il livello massimo della scala di valutazione.
setRequired(enabled)	RatingItem	Imposta se il rispondente deve rispondere alla domanda.
setTitle(title)	RatingItem	Imposta 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 valutazione.

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 response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

Parametri

Nome	Tipo	Descrizione
response	Integer	Una risposta con un valore per questo elemento di valutazione.

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

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

---

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

---

getRatingIcon()

Recupera l'icona scelta per la valutazione.

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

Indietro

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

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

Indietro

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

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

Restituisce 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

---

isRequired()

Determina se il rispondente deve rispondere alla domanda.

Indietro

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

Parametri

Nome	Tipo	Descrizione
feedback	QuizFeedback	il nuovo feedback

Indietro

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

Nome	Tipo	Descrizione
text	String	il nuovo testo della guida

Indietro

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

Nome	Tipo	Descrizione
points	Integer	il numero di punti che vale una domanda

Indietro

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

---

setRatingIcon(ratingIcon)

Imposta l'icona della valutazione.

Genera un'eccezione di scripting se il tipo di icona di 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

Nome	Tipo	Descrizione
ratingIcon	RatingIconType	Il tipo di icona di valutazione.

Indietro

RatingItem — This RatingItem, for chaining.

Lanci

Error: se il tipo di icona di classificazione 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 massimo della scala di valutazione. Il livello massimo della scala di valutazione deve essere compreso tra 3 e 10 inclusi. Una nuova valutazione ha come livello della scala di valutazione predefinito 3.

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

Nome	Tipo	Descrizione
ratingScaleLevel	Integer	Il livello della scala di valutazione.

Indietro

RatingItem — This RatingItem, for chaining.

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

Nome	Tipo	Descrizione
enabled	Boolean	se il rispondente deve rispondere alla domanda

Indietro

RatingItem: 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

Nome	Tipo	Descrizione
title	String	il nuovo testo del titolo o dell'intestazione

Indietro

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