Diese Seite wurde von der Cloud Translation API übersetzt.

Class ScaleItem

Ein Frageelement, mit dem der Befragte eine Antwortoption aus einer nummerierten Reihe von Optionsfeldern auswählen kann Schaltflächen. Elemente können über ein Form erstellt oder aufgerufen werden. Wenn diese Elemente in einem Quiz verwendet werden, benotet sind.

// 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 Skalierungselement.
`duplicate()`	`ScaleItem`	Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
`getGeneralFeedback()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten.
`getHelpText()`	`String`	Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet.
`getId()`	`Integer`	Ruft die eindeutige Kennzeichnung des Artikels ab.
`getIndex()`	`Integer`	Ruft den Index des Elements unter allen Elementen im Formular ab.
`getLeftLabel()`	`String`	Ruft das Label für die Untergrenze der Skala ab, falls vorhanden.
`getLowerBound()`	`Integer`	Ruft die Untergrenze der Skala ab.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benoteten 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. Wird manchmal als Überschrifttext bezeichnet, im Fall von `SectionHeaderItem`.
`getType()`	`ItemType`	Ruft den Typ des Elements ab, dargestellt als `ItemType`.
`getUpperBound()`	`Integer`	Ruft die Obergrenze der Skala ab.
`isRequired()`	`Boolean`	Bestimmt, 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 Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat.
`setHelpText(text)`	`ScaleItem`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` 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 benotetes Element wert ist.
`setRequired(enabled)`	`ScaleItem`	Legt fest, ob der Befragte die Frage beantworten muss.
`setTitle(title)`	`ScaleItem`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `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

Name	Typ	Beschreibung
`response`	`Integer`	eine Wertantwort für dieses Skalenelement

Rückflug

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 am Ende des Formulars an.

Rückflug

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

`getGeneralFeedback()`

Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten.

Rückflug

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()`

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

Rückflug

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 Kennzeichnung des Artikels ab.

Rückflug

Integer: die 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 unter allen Elementen im Formular ab.

Rückflug

Integer – 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, falls vorhanden.

Rückflug

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 Skala ab.

Rückflug

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

`getPoints()`

Gibt die Punktzahl eines benoteten Elements zurück

Rückflug

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.

Rückflug

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. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.

Rückflug

String: Titel oder Text der Überschrift 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.

Rückflug

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.

Rückflug

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

`isRequired()`

Bestimmt, ob der Teilnehmer die Frage beantworten muss.

Rückflug

Boolean – 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 Die Obergrenze muss zwischen 3 und 10 liegen. Eine neue Skala wird standardmäßig auf Untergrenze von 1 und Obergrenze von 5.

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

Parameter

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

Rückflug

ScaleItem – diese 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 Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat.

Parameter

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback

Rückflug

ScaleItem – diese 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 (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

Name	Typ	Beschreibung
`text`	`String`	den neuen Hilfetext

Rückflug

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

Rückflug

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

Rückflug

ScaleItem – diese 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 Befragte die Frage beantworten muss.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob der Befragte die Frage beantworten muss.

Rückflug

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

`setTitle(title)`

Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Überschriftentext

Rückflug

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