Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

Metodo	Tipo restituito	Breve descrizione
`createResponse(response)`	`ItemResponse`	Crea un nuovo `ItemResponse` per questo elemento di classificazione.
`duplicate()`	`RatingItem`	Crea una copia di questo elemento e la aggiunge alla fine del modulo.
`getGeneralFeedback()`	`QuizFeedback`	Restituisce il feedback mostrato ai partecipanti quando rispondono a una domanda con voto.
`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`	Recupera l'identificatore univoco dell'elemento.
`getIndex()`	`Integer`	Recupera 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 classificazione.
`getRatingScaleLevel()`	`Integer`	Recupera 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`	Recupera il tipo di elemento, rappresentato come `ItemType`.
`isRequired()`	`Boolean`	Determina se il rispondente deve rispondere alla domanda.
`setGeneralFeedback(feedback)`	`RatingItem`	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).
`setHelpText(text)`	`RatingItem`	Imposta il testo di aiuto dell'elemento (a volte chiamato testo descrittivo per elementi di layout come `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setPoints(points)`	`RatingItem`	Imposta il numero di punti attribuiti a un elemento valutabile.
`setRatingIcon(ratingIcon)`	`RatingItem`	Imposta l'icona della classificazione.
`setRatingScaleLevel(ratingScaleLevel)`	`RatingItem`	Imposta il livello 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 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

Nome	Tipo	Descrizione
`response`	`Integer`	Una 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

Nome	Tipo	Descrizione
`feedback`	`QuizFeedback`	il 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

Nome	Tipo	Descrizione
`text`	`String`	il 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

Nome	Tipo	Descrizione
`points`	`Integer`	il 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

Nome	Tipo	Descrizione
`ratingIcon`	`RatingIconType`	Il 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

Nome	Tipo	Descrizione
`ratingScaleLevel`	`Integer`	Il 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

Nome	Tipo	Descrizione
`enabled`	`Boolean`	se 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

Nome	Tipo	Descrizione
`title`	`String`	il 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