Class ScaleItem

Artikel in der Skalierung

Ein Frageelement, bei dem die Teilnehmer eine Option aus einer nummerierten Reihe von Optionsfeldern auswählen 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 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 eine neue ItemResponse für dieses Skalierungselement.
duplicate()ScaleItemErstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
getGeneralFeedback()QuizFeedbackGibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerDie eindeutige Kennung des Artikels.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getLeftLabel()StringDas Label für die Untergrenze der Skala, falls vorhanden.
getLowerBound()IntegerDie Untergrenze der Skala.
getPoints()IntegerGibt die Punktzahl eines benoteten Elements zurück.
getRightLabel()StringDas Label für die Obergrenze der Skala, falls vorhanden.
getTitle()StringDer Titel des Artikels (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).
getType()ItemTypeDer Typ des Artikels, dargestellt als ItemType.
getUpperBound()IntegerDie Obergrenze der Skala wird abgerufen.
isRequired()BooleanBestimmt, ob die Befragten die Frage beantworten müssen.
setBounds(lower, upper)ScaleItemLegt die Unter- und Obergrenze der Skala fest.
setGeneralFeedback(feedback)ScaleItemHier 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)ScaleItemHiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).
setLabels(lower, upper)ScaleItemHier legen Sie Labels für die Unter- und Obergrenze der Skala fest.
setPoints(points)ScaleItemHiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist.
setRequired(enabled)ScaleItemHier legen Sie fest, ob die Befragten die Frage beantworten müssen.
setTitle(title)ScaleItemHiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Detaillierte Dokumentation

createResponse(response)

Erstellt eine neue 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 Antwort für diesen Skalenpunkt

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 hängt sie an das Ende des Formulars an.

Rückflug

ScaleItem – ein Duplikat dieses ScaleItem 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

getLeftLabel()

Das Label für die Untergrenze der Skala, falls vorhanden.

Rückflug

String: Label für die Untergrenze der Skala

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

getLowerBound()

Die Untergrenze der Skala.

Rückflug

Integer – die Untergrenze der Skala

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

getRightLabel()

Das Label für die Obergrenze der Skala, falls vorhanden.

Rückflug

String – das Label für die Obergrenze der Skala

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

getUpperBound()

Die Obergrenze der Skala wird abgerufen.

Rückflug

Integer – Obergrenze der Skala

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

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. Für eine neue Skala wird standardmäßig eine untere Grenze von 1 und eine obere Grenze von 5 festgelegt.

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

Parameter

NameTypBeschreibung
lowerIntegerdie neue Untergrenze
upperIntegerdie neue Obergrenze

Rückflug

ScaleItem – dieses ScaleItem für die Verkettung

Löst

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

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

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Rückflug

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

NameTypBeschreibung
textStringden neuen Hilfetext

Rückflug

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

setLabels(lower, upper)

Hier legen Sie 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 – dieses ScaleItem 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

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die ein Frageelement wert ist

Rückflug

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

setRequired(enabled)

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

Parameter

NameTypBeschreibung
enabledBooleanob die Befragten die Frage beantworten müssen

Rückflug

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

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

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