Diese Seite wurde von der Cloud Translation API übersetzt.

Class ScaleItem

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

Methode	Rückgabetyp	Kurzbeschreibung
`createResponse(response)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Maßstabselement.
`duplicate()`	`ScaleItem`	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.
`getLeftLabel()`	`String`	Das Label für die Untergrenze der Skala, falls vorhanden.
`getLowerBound()`	`Integer`	Die Untergrenze der Skala.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benoteten Elements zurück.
`getRightLabel()`	`String`	Das Label für die Obergrenze der Skala, falls vorhanden.
`getTitle()`	`String`	Der Titel des Artikels (im Fall einer `SectionHeaderItem` auch als Headertext bezeichnet).
`getType()`	`ItemType`	Der Typ des Artikels, dargestellt als `ItemType`.
`getUpperBound()`	`Integer`	Die Obergrenze der Skala wird abgerufen.
`isRequired()`	`Boolean`	Bestimmt, ob die Befragten die Frage beantworten müssen.
`setBounds(lower, upper)`	`ScaleItem`	Legt die Unter- und Obergrenze der Skala fest.
`setGeneralFeedback(feedback)`	`ScaleItem`	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)`	`ScaleItem`	Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` auch als Beschreibungstext bezeichnet).
`setLabels(lower, upper)`	`ScaleItem`	Hier legen Sie Labels für die Unter- und Obergrenze der Skala fest.
`setPoints(points)`	`ScaleItem`	Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist.
`setRequired(enabled)`	`ScaleItem`	Hier legen Sie fest, ob die Befragten die Frage beantworten müssen.
`setTitle(title)`	`ScaleItem`	Hiermit 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

Name	Typ	Beschreibung
`response`	`Integer`	eine 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 fügt sie am Ende des Formulars ein.

Rückflug

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

Name	Typ	Beschreibung
`lower`	`Integer`	die neue Untergrenze
`upper`	`Integer`	die neue Obergrenze

Rückflug

ScaleItem – dieses ScaleItem für die Verkettung

Löst aus

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

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das 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

Name	Typ	Beschreibung
`text`	`String`	den 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

Name	Typ	Beschreibung
`lower`	`String`	das neue Label für die Untergrenze
`upper`	`String`	das 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

Name	Typ	Beschreibung
`points`	`Integer`	die 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

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

Rückflug

ScaleItem – das aktuelle Element (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

`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

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