Class ScaleItem

ScaleItem

Ein Frageelement, bei dem der Teilnehmer eine Option aus einer nummerierten Reihe von Optionsfeldern auswählen kann. Auf Elemente kann über eine Form zugegriffen oder sie können über eine Form erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie bewertet. 

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

Methoden

MethodeRückgabetypKurzbeschreibung
createResponse(response)ItemResponseErstellt ein neues ItemResponse für dieses Skalierungselement.
duplicate()ScaleItemErstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
getGeneralFeedback()QuizFeedback|nullGibt 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.
getLeftLabel()StringGibt das Label für die Untergrenze der Skala zurück, falls vorhanden.
getLowerBound()IntegerGibt die Untergrenze der Skala zurück.
getPoints()IntegerGibt den Punktwert eines bewertbaren Elements zurück.
getRightLabel()StringGibt das Label für die Obergrenze der Skala zurück, falls vorhanden.
getTitle()StringRuft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Header-Text bezeichnet).
getType()ItemTypeRuft den Typ des Elements als ItemType ab.
getUpperBound()IntegerGibt die Obergrenze der Skala zurück.
isRequired()BooleanGibt an, ob der Befragte die Frage beantworten muss.
setBounds(lower, upper)ScaleItemLegt die Unter- und Obergrenze der Skala fest.
setGeneralFeedback(feedback)ScaleItemLegt 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)ScaleItemLegt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setLabels(lower, upper)ScaleItemLegt Labels für die Unter- und Obergrenze der Skala fest.
setPoints(points)ScaleItemLegt die Anzahl der Punkte fest, die ein bewertbares Element wert ist.
setRequired(enabled)ScaleItemLegt fest, ob der Befragte die Frage beantworten muss.
setTitle(title)ScaleItemLegt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Detaillierte Dokumentation

createResponse(response)

Erstellt ein neues ItemResponse für dieses Skalierungselement. Löst eine Ausnahme aus, wenn das response-Argument außerhalb der für das Element festgelegten Grenzen liegt.

Parameter

NameTypBeschreibung
responseIntegereine Wertantwort für diesen Skalenartikel

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

ScaleItem – ein Duplikat dieses ScaleItem 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|null – das Feedback, sofern 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

getLeftLabel()

Gibt das Label für die Untergrenze der Skala zurück, falls vorhanden.

Rückflug

String: Das Label für die Untergrenze der Skala.

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

getLowerBound()

Gibt die Untergrenze der Skala zurück.

Rückflug

Integer: die Untergrenze der Skala

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

getRightLabel()

Gibt das Label für die Obergrenze der Skala zurück, falls vorhanden.

Rückflug

String: Das Label für die Obergrenze der Skala.

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 Header-Text 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

getUpperBound()

Gibt die Obergrenze der Skala zurück.

Rückflug

Integer: Obergrenze der Skala

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

setBounds(lower, upper)

Legt die Unter- und Obergrenze der Skala fest. Die Untergrenze muss 0 oder 1 sein. Die Obergrenze muss zwischen 3 und 10 liegen (jeweils einschließlich). Für eine neue Skala wird standardmäßig eine Untergrenze von 1 und eine Obergrenze von 5 festgelegt.

Löst eine Scripting-Ausnahme aus, wenn die angegebenen Werte außerhalb der zulässigen Grenzwerte liegen. Dezimalstellen werden auf die vorherige Ganzzahl gekürzt.

Parameter

NameTypBeschreibung
lowerIntegerdie neue Untergrenze
upperIntegerdie neue Obergrenze

Rückflug

ScaleItem – diese ScaleItem zur Verkettung

Löst

Error: wenn die Unter- oder Obergrenze 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

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

ScaleItem – diese ScaleItem 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

ScaleItem – diese ScaleItem 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

setLabels(lower, upper)

Legt Labels für die Unter- und Obergrenze der Skala fest.

Parameter

NameTypBeschreibung
lowerStringdas neue Label für die Untergrenze
upperStringdas neue Label für die Obergrenze

Rückflug

ScaleItem – diese ScaleItem 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 eine Frage wert ist

Rückflug

ScaleItem – diese ScaleItem 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

setRequired(enabled)

Legt fest, ob der Befragte die Frage beantworten muss.

Parameter

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss

Rückflug

ScaleItem – 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

ScaleItem – diese ScaleItem 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