Class ScaleItem

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
ScaleItem

Ein Fragenelement, bei dem der Teilnehmer eine Option aus einer nummerierten Abfolge von Optionsfeldern auswählen kann. Elemente können über ein Form aufgerufen oder erstellt werden. Wenn Sie sie in einem Quiz verwenden, werden sie benotet.

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

Methoden

MethodeRückgabetypKurzbeschreibung
createResponse(response)ItemResponseErstellt eine neue ItemResponse für dieses Skalierungselement.
duplicate()ScaleItemErstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
getGeneralFeedback()QuizFeedbackGibt das Feedback zurück, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
getHelpText()StringRuft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements aus allen Elementen im Formular ab.
getLeftLabel()StringRuft das Label für die Untergrenze der Skala ab (sofern vorhanden).
getLowerBound()IntegerRuft die Untergrenze der Waage ab.
getPoints()IntegerGibt die Punktzahl eines benotebaren Elements zurück.
getRightLabel()StringRuft das Label für die Obergrenze der Skala ab (sofern vorhanden).
getTitle()StringRuft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.
getType()ItemTypeRuft den Elementtyp ab, dargestellt als ItemType.
getUpperBound()IntegerRuft die Obergrenze der Waage ab.
isRequired()BooleanLegt fest, ob der Teilnehmer die Frage beantworten muss.
setBounds(lower, upper)ScaleItemLegt die Unter- und Obergrenze der Skala fest.
setGeneralFeedback(feedback)ScaleItemLegt das Feedback fest, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten, die keine richtige oder falsche Antwort enthält (d. h. Fragen, für die eine manuelle Benotung erforderlich ist).
setHelpText(text)ScaleItemLegt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
setLabels(lower, upper)ScaleItemLegt die Unter- und Obergrenze der Beschriftung fest.
setPoints(points)ScaleItemLegt die Anzahl der Punkte fest, die ein Element in einer Benotung wert ist.
setRequired(enabled)ScaleItemLegt fest, ob der Teilnehmer die Frage beantworten muss.
setTitle(title)ScaleItemLegt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)

Detaillierte Dokumentation

createResponse(response)

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

Parameter

NameTypBeschreibung
responseIntegereine Wertantwort für dieses Skalierungselement

Zurücksenden

ItemResponse: die Antwort des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

duplicate()

Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.

Zurücksenden

ScaleItem: ein Duplikat dieses ScaleItem, für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getGeneralFeedback()

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

Zurücksenden

QuizFeedback: Das Feedback, falls vorhanden.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getHelpText()

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

Zurücksenden

String: der Hilfe- oder Beschreibungstext des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getId()

Ruft die eindeutige Kennung des Elements ab.

Zurücksenden

Integer: die ID des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getIndex()

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

Zurücksenden

Integer: Der Index des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getLeftLabel()

Ruft das Label für die Untergrenze der Skala ab (sofern vorhanden).

Zurücksenden

String: Das Label für die Untergrenze der Waage

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getLowerBound()

Ruft die Untergrenze der Waage ab.

Zurücksenden

Integer: Die Untergrenze der Waage

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getPoints()

Gibt die Punktzahl eines benotebaren Elements zurück.

Zurücksenden

Integer: Gibt an, wie viele Punkte eine Frage hat.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getRightLabel()

Ruft das Label für die Obergrenze der Skala ab (sofern vorhanden).

Zurücksenden

String: Das Label für die Obergrenze der Waage

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getTitle()

Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.

Zurücksenden

String: Titel oder Titel des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getType()

Ruft den Elementtyp ab, dargestellt als ItemType.

Zurücksenden

ItemType: Typ des Elements

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getUpperBound()

Ruft die Obergrenze der Waage ab.

Zurücksenden

Integer: Obergrenze der Waage

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

isRequired()

Legt fest, ob der Teilnehmer die Frage beantworten muss.

Zurücksenden

Boolean: Gibt an, ob der Teilnehmer die Frage beantworten muss

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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. Eine neue Skala wird standardmäßig auf eine Untergrenze von 1 und eine Obergrenze von 5 festgelegt.

Löst eine Skriptausnahme aus, wenn die angegebenen Werte außerhalb der zulässigen Limits liegen Dezimalzahlen werden auf die vorherige Ganzzahl gekürzt.

Parameter

NameTypBeschreibung
lowerIntegerdie neue Untergrenze
upperIntegerdie neue Obergrenze

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Throws

Error – wenn die Unter- oder Obergrenze ungültig ist

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setGeneralFeedback(feedback)

Legt das Feedback fest, das Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten, die keine richtige oder falsche Antwort enthält (d. h. Fragen, für die eine manuelle Benotung erforderlich ist).

Parameter

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setHelpText(text)

Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).

Parameter

NameTypBeschreibung
textStringden neuen Hilfetext

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setLabels(lower, upper)

Legt die Unter- und Obergrenze der Beschriftung fest.

Parameter

NameTypBeschreibung
lowerStringDas neue Label für die Untergrenze
upperStringdas neue Label für die Obergrenze.

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setPoints(points)

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

Parameter

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die ein Frageartikel wert ist

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setRequired(enabled)

Legt fest, ob der Teilnehmer die Frage beantworten muss.

Parameter

NameTypBeschreibung
enabledBooleanob der Teilnehmer die Frage beantworten muss

Zurücksenden

ScaleItem: das aktuelle Element (zum Verketten)

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setTitle(title)

Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Titel

Zurücksenden

ScaleItem – dieser ScaleItem für Verkettung

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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