Diese Seite wurde von der Cloud Translation API übersetzt.

Class RatingItem

Ein Frageelement, mit dem die Befragten eine Bewertung abgeben können. Auf Elemente kann über ein Form zugegriffen oder sie können dort erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie benotet.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createResponse(response)`	`ItemResponse`	Erstellt ein neues `ItemResponse` für dieses Bewertungselement.
`duplicate()`	`RatingItem`	Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
`getGeneralFeedback()`	`QuizFeedback`	Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
`getHelpText()`	`String`	Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`getId()`	`Integer`	Die eindeutige Kennung des Artikels.
`getIndex()`	`Integer`	Ruft den Index des Elements unter allen Elementen im Formular ab.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benoteten Elements zurück.
`getRatingIcon()`	`RatingIconType`	Das für die Altersfreigabe ausgewählte Symbol.
`getRatingScaleLevel()`	`Integer`	Ruft die Skalenebene der Bewertung ab.
`getTitle()`	`String`	Der Titel des Artikels (im Fall eines `SectionHeaderItem` auch als Headertext bezeichnet).
`getType()`	`ItemType`	Der Typ des Artikels, dargestellt als `ItemType`.
`isRequired()`	`Boolean`	Bestimmt, ob die Befragten die Frage beantworten müssen.
`setGeneralFeedback(feedback)`	`RatingItem`	Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine bewertbare Frage beantworten, die keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell benotet werden müssen).
`setHelpText(text)`	`RatingItem`	Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` auch als Beschreibungstext bezeichnet).
`setPoints(points)`	`RatingItem`	Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist.
`setRatingIcon(ratingIcon)`	`RatingItem`	Hier legen Sie das Symbol für die Altersfreigabe fest.
`setRatingScaleLevel(ratingScaleLevel)`	`RatingItem`	Legt die maximale Skalenebene der Bewertung fest.
`setRequired(enabled)`	`RatingItem`	Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.
`setTitle(title)`	`RatingItem`	Hiermit wird der Titel des Artikels festgelegt (im Fall eines `SectionHeaderItem` auch als Headertext bezeichnet).

Detaillierte Dokumentation

`createResponse(response)`

Erstellt ein neues ItemResponse für dieses Bewertungselement.

Es wird eine Scripting-Ausnahme ausgelöst, wenn der angegebene Wert für response kleiner als 1 oder größer als der von getRatingScaleLevel() zurückgegebene Wert ist.

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

Parameter

Name	Typ	Beschreibung
`response`	`Integer`	Eine Antwort für dieses Bewertungselement.

Rückflug

ItemResponse: Die Artikelantwort.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`duplicate()`

Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.

Rückflug

RatingItem – ein Duplikat dieses RatingItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getGeneralFeedback()`

Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.

Rückflug

QuizFeedback: gegebenenfalls das Feedback

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String: Hilfetext oder Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

Die eindeutige Kennung des Artikels.

Rückflug

Integer: die Artikel-ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

Ruft den Index des Elements unter allen Elementen im Formular ab.

Rückflug

Integer: der Index des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getPoints()`

Gibt die Punktzahl eines benoteten Elements zurück.

Rückflug

Integer: Die Punktzahl, die eine Frage wert ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRatingIcon()`

Das für die Altersfreigabe ausgewählte Symbol.

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

Rückflug

RatingIconType: Der Typ des Bewertungssymbols.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getRatingScaleLevel()`

Ruft die Skalenebene der Bewertung ab.

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

Rückflug

Integer: Die Bewertungsskala.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

Der Titel des Artikels (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Rückflug

String – Titel oder Headertext des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

Der Typ des Artikels, dargestellt als ItemType.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isRequired()`

Bestimmt, ob die Befragten die Frage beantworten müssen.

Rückflug

Boolean – ob die Befragten die Frage beantworten müssen

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setGeneralFeedback(feedback)`

Hier legen Sie fest, welches Feedback den Teilnehmern angezeigt wird, wenn sie eine bewertbare Frage beantworten, die keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell benotet werden müssen).

Parameter

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback

Rückflug

RatingItem – dieses RatingItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).

Parameter

Name	Typ	Beschreibung
`text`	`String`	den neuen Hilfetext

Rückflug

RatingItem – dieses RatingItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setPoints(points)`

Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. Der Standardwert für neue Elemente ist 0.

Parameter

Name	Typ	Beschreibung
`points`	`Integer`	die Anzahl der Punkte, die ein Frageelement wert ist

Rückflug

RatingItem – dieses RatingItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRatingIcon(ratingIcon)`

Hier legen Sie das Symbol für die Altersfreigabe fest.

Löst eine Scripting-Ausnahme aus, wenn der Typ des Altersfreigabesymbols ungültig ist.

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

Parameter

Name	Typ	Beschreibung
`ratingIcon`	`RatingIconType`	Der Typ des Altersfreigabesymbols.

Rückflug

RatingItem – Dieses RatingItem für die Verkettung.

Löst

Error, wenn der Bewertungssymboltyp ungültig ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRatingScaleLevel(ratingScaleLevel)`

Legt die maximale Skalenebene der Bewertung fest. Die maximale Skalenebene der Altersfreigabe muss zwischen 3 und 10 liegen (jeweils einschließlich). Für eine neue Bewertung wird standardmäßig die Bewertungsskala 3 verwendet.

Löst eine Scripting-Ausnahme aus, wenn die angegebenen Werte außerhalb der zulässigen Grenzen liegen.

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

Parameter

Name	Typ	Beschreibung
`ratingScaleLevel`	`Integer`	Die Bewertungsskala.

Rückflug

RatingItem – Dieses RatingItem für die Verkettung.

Löst

Error: Die Bewertungsskala ist auf einem ungültigen Wert.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRequired(enabled)`

Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob die Befragten die Frage beantworten müssen

Rückflug

RatingItem – das aktuelle Element (für die Verknüpfung)

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Headertext

Rückflug

RatingItem – dieses RatingItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms