Class RatingItem

Bewertung

Ein Frageelement, mit dem der Befragte eine Bewertung abgeben kann. Auf Elemente kann über eine Form zugegriffen oder es können Elemente über eine Form erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie bewertet. 

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

MethodeRückgabetypKurzbeschreibung
createResponse(response)ItemResponseErstellt ein neues ItemResponse für dieses Bewertungselement.
duplicate()RatingItemErstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
getGeneralFeedback()QuizFeedbackGibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie auf eine benotbare Frage antworten.
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getPoints()IntegerGibt den Punktwert eines bewertbaren Elements zurück.
getRatingIcon()RatingIconTypeRuft das für die Bewertung ausgewählte Symbol ab.
getRatingScaleLevel()IntegerRuft das Skalierungsniveau der Altersfreigabe ab.
getTitle()StringRuft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).
getType()ItemTypeRuft den Typ des Elements als ItemType ab.
isRequired()BooleanGibt an, ob der Befragte die Frage beantworten muss.
setGeneralFeedback(feedback)RatingItemLegt das Feedback fest, das den Teilnehmern angezeigt wird, wenn sie auf eine Frage antworten, die bewertet werden kann, aber keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell bewertet werden müssen).
setHelpText(text)RatingItemLegt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setPoints(points)RatingItemLegt die Anzahl der Punkte fest, die ein bewertbares Element wert ist.
setRatingIcon(ratingIcon)RatingItemLegt das Symbol für die Altersfreigabe fest.
setRatingScaleLevel(ratingScaleLevel)RatingItemLegt die maximale Skalierungsstufe der Bewertung fest.
setRequired(enabled)RatingItemLegt fest, ob der Befragte die Frage beantworten muss.
setTitle(title)RatingItemLegt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Detaillierte Dokumentation

createResponse(response)

Erstellt ein neues ItemResponse für dieses Bewertungselement.

Löst eine Scripting-Ausnahme aus, wenn der angegebene 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

NameTypBeschreibung
responseIntegerEine Wertantwort für dieses Bewertungselement.

Rückflug

ItemResponse: Die Antwort auf das Element.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 auf eine benotbare Frage antworten.

Rückflug

QuizFeedback – das Feedback, falls vorhanden.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String – der Hilfetext oder die Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getId()

Ruft die eindeutige Kennung des Elements ab.

Rückflug

Integer: die ID des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getPoints()

Gibt den Punktwert eines bewertbaren Elements zurück.

Rückflug

Integer: Die Anzahl der Punkte, die eine Frage wert ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRatingIcon()

Ruft das für die Bewertung ausgewählte Symbol ab. 

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getRatingScaleLevel()

Ruft das Skalierungsniveau der Altersfreigabe 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: Der Wert auf der Bewertungsskala.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getTitle()

Ruft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Rückflug

String – der Titel oder Headertext des Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getType()

Ruft den Typ des Elements als ItemType ab.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

isRequired()

Gibt an, ob der Befragte die Frage beantworten muss.

Rückflug

Boolean – ob der Befragte die Frage beantworten muss

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setGeneralFeedback(feedback)

Legt das Feedback fest, das den Teilnehmern angezeigt wird, wenn sie auf eine Frage antworten, die bewertet werden kann, aber keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell bewertet werden müssen).

Parameter

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Rückflug

RatingItem – diese RatingItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setHelpText(text)

Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

NameTypBeschreibung
textStringder neue Hilfetext

Rückflug

RatingItem – diese RatingItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setPoints(points)

Legt die Anzahl der Punkte fest, die ein bewertbares Element wert ist. Der Standardwert für neue Elemente ist 0.

Parameter

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die ein Frageelement wert ist

Rückflug

RatingItem – diese RatingItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setRatingIcon(ratingIcon)

Legt das Symbol für die Altersfreigabe fest.

Löst eine Scripting-Ausnahme aus, wenn der Typ des Altersfreigabe-Symbols 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

NameTypBeschreibung
ratingIconRatingIconTypeDer Typ des Bewertungssymbols.

Rückflug

RatingItem – Diese RatingItem zur Verkettung.

Löst

Error: Wenn der Typ des Bewertungssymbols ungültig ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setRatingScaleLevel(ratingScaleLevel)

Legt die maximale Skalierungsstufe der Bewertung fest. Die maximale Skalierungsstufe der Bewertung muss zwischen 3 und 10 (einschließlich) liegen. Eine neue Bewertung hat standardmäßig die Bewertungsskala 3.

Löst eine Scripting-Ausnahme aus, wenn die angegebenen Werte außerhalb der zulässigen Grenzwerte 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

NameTypBeschreibung
ratingScaleLevelIntegerDer Wert auf der Bewertungsskala.

Rückflug

RatingItem – Diese RatingItem zur Verkettung.

Löst

Error: wenn die Bewertungsskala ungültig ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setRequired(enabled)

Legt fest, ob der Befragte die Frage beantworten muss.

Parameter

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss

Rückflug

RatingItem – das aktuelle Element (zum Verketten)

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

setTitle(title)

Legt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

RatingItem – diese RatingItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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