Ein Frageelement, bei dem der Befragte eine Option aus einer nummerierten Abfolge von Optionsfeldern auswählen kann. Elemente können über Form
aufgerufen oder erstellt werden. Diese Elemente werden
benotet, wenn sie in einem Quiz verwendet werden.
// 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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
createResponse(response) | ItemResponse | Erstellt eine neue ItemResponse für dieses Waagenelement. |
duplicate() | ScaleItem | Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an. |
getGeneralFeedback() | QuizFeedback | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie auf eine benotete Frage antworten. |
getHelpText() | String | den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet) |
getId() | Integer | Ruft die eindeutige ID des Artikels ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getLeftLabel() | String | Ruft das Label für die Untergrenze der Skala ab, sofern vorhanden. |
getLowerBound() | Integer | Ruft die Untergrenze der Waage ab. |
getPoints() | Integer | Gibt die Punktzahl eines benotbaren Elements zurück. |
getRightLabel() | String | Ruft das Label für die Obergrenze der Skala ab, falls vorhanden. |
getTitle() | String | Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem -Elements manchmal auch als Überschrifttext bezeichnet). |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
getUpperBound() | Integer | Ruft die Obergrenze der Skala ab. |
isRequired() | Boolean | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setBounds(lower, upper) | ScaleItem | Legt die Unter- und Obergrenze der Skala fest. |
setGeneralFeedback(feedback) | ScaleItem | Legt fest, dass das Feedback den Teilnehmern angezeigt wird, wenn sie auf eine benotete Frage antworten, die keine richtige oder falsche Antwort hat (z. B. Fragen, die manuell benotet werden müssen). |
setHelpText(text) | ScaleItem | Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems , PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet. |
setLabels(lower, upper) | ScaleItem | Legt Labels für die Unter- und Obergrenze der Skala fest. |
setPoints(points) | ScaleItem | Legt die Anzahl der Punkte fest, die ein benotbares Element wert ist. |
setRequired(enabled) | ScaleItem | Legt fest, ob der Teilnehmer die Frage beantworten muss. |
setTitle(title) | ScaleItem | Legt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet. |
Detaillierte Dokumentation
createResponse(response)
Erstellt eine neue ItemResponse
für dieses Waagenelement. Löst eine Ausnahme aus, wenn das Argument response
außerhalb der für das Element festgelegten Grenzen liegt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
response | Integer | eine wertbasierte Antwort für dieses Skalenelement |
Return
ItemResponse
: die Elementantwort
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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.
Return
ScaleItem
– ein Duplikat dieses ScaleItem
für die Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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 auf eine benotete Frage antworten.
Return
QuizFeedback
: das Feedback, falls vorhanden.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet)
Return
String
: Hilfe- oder Beschreibungstext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige ID des Artikels ab.
Return
Integer
: ID des Artikels
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Return
Integer
: der Index des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Return
String
: Das Label für die Untergrenze der Skala
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getLowerBound()
Ruft die Untergrenze der Waage ab.
Return
Integer
: Untergrenze der Waage
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Gibt die Punktzahl eines benotbaren Elements zurück.
Return
Integer
: die Anzahl der Punkte, die eine Frage wert ist.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRightLabel()
Ruft das Label für die Obergrenze der Skala ab, falls vorhanden.
Return
String
: Das Label für die Obergrenze der Skala
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem
-Elements manchmal auch als Überschrifttext bezeichnet).
Return
String
: Titel oder Überschriftentext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements ab, dargestellt als ItemType
.
Return
ItemType
: Typ des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUpperBound()
Ruft die Obergrenze der Skala ab.
Return
Integer
: Obergrenze der Skala
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Legt fest, ob der Teilnehmer die Frage beantworten muss.
Return
Boolean
: Gibt an, ob der Teilnehmer die Frage beantworten muss
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren 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. Eine neue Skala ist standardmäßig auf die Untergrenze von 1
und eine Obergrenze von 5
gesetzt.
Löst eine Skriptausnahme aus, wenn die angegebenen Werte die zulässigen Grenzwerte überschreiten. Dezimalzahlen werden auf die vorherige Ganzzahl gekürzt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
lower | Integer | die neue Untergrenze |
upper | Integer | die neue Obergrenze |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Löst aus
Error
: Wenn die Unter- oder Obergrenze ungültig ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Legt fest, dass das Feedback den Teilnehmern angezeigt wird, wenn sie auf eine benotete Frage antworten, die keine richtige oder falsche Antwort hat (z. B. Fragen, die manuell benotet werden müssen).
Parameter
Name | Typ | Beschreibung |
---|---|---|
feedback | QuizFeedback | das neue Feedback |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems
, PageBreakItems
und SectionHeaderItems
wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | dem neuen Hilfetext |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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
Name | Typ | Beschreibung |
---|---|---|
lower | String | das neue Label für die Untergrenze |
upper | String | das neue Label für die Obergrenze |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Legt die Anzahl der Punkte fest, die ein benotbares Element wert ist. Der Standardwert für neue Elemente ist 0.
Parameter
Name | Typ | Beschreibung |
---|---|---|
points | Integer | die Anzahl der Punkte, die eine Frage wert ist |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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
Name | Typ | Beschreibung |
---|---|---|
enabled | Boolean | ob der Befragte die Frage beantworten muss |
Return
ScaleItem
: das aktuelle Element (zur Verkettung)
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest. Bei SectionHeaderItem
wird dieser Text manchmal auch als Überschrifttext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | dem neuen Titel oder Text der Überschrift |
Return
ScaleItem
– dieses ScaleItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms