Ein Frageelement, in dem der Befragte einen Textblock eingeben kann. Auf Elemente kann über ein Form zugegriffen oder sie können darüber erstellt werden. Wenn diese Elemente in einem Test verwendet werden, werden sie bewertet.
// Open a form by ID and add a new paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
clear | Paragraph | Entfernt die Datenvalidierung für dieses Absatztextelement. |
create | Item | Erstellt ein neues Item für dieses Absatztextelement. |
duplicate() | Paragraph | Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein. |
get | Quiz | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie auf eine benotbare Frage antworten. |
get | String | Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie Image, Page und Section bezeichnet). |
get | Integer | Ruft die eindeutige Kennung des Elements ab. |
get | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
get | Integer | Gibt den Punktwert eines bewertbaren Elements zurück. |
get | String | Ruft den Titel des Elements ab (bei einem Section manchmal auch als Überschrift bezeichnet). |
get | Item | Ruft den Typ des Elements als Item ab. |
is | Boolean | Gibt an, ob der Befragte die Frage beantworten muss. |
set | Paragraph | Legt das Feedback fest, das den Teilnehmern angezeigt wird, wenn sie auf eine Frage antworten, die bewertet werden kann, aber keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell bewertet werden müssen). |
set | Paragraph | Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie Image, Page und Section bezeichnet). |
set | Paragraph | Legt die Anzahl der Punkte fest, die ein bewertbares Element wert ist. |
set | Paragraph | Legt fest, ob der Befragte die Frage beantworten muss. |
set | Paragraph | Legt den Titel des Elements fest (bei einem Section manchmal auch als Überschrift bezeichnet). |
set | Paragraph | Legt die Datenvalidierung für dieses Absatztextelement fest. |
Detaillierte Dokumentation
clearValidation()
Entfernt die Datenvalidierung für dieses Absatztextelement.
Rückflug
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createResponse(response)
Erstellt ein neues Item für dieses Absatztextelement.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
response | String | eine Antwort auf die Frage, die im Element gestellt wird |
Rückflug
Item – die Antwort auf das Element
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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
Paragraph – ein Duplikat dieses Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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 benotbare Frage antworten.
Rückflug
Quiz – das Feedback, falls vorhanden.
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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 Layout-Elemente wie Image, Page und Section bezeichnet).
Rückflug
String – der Hilfetext oder die Beschreibung des Artikels
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Rückflug
Integer: die ID des Artikels
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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 Elements
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Gibt den Punktwert eines bewertbaren Elements zurück.
Rückflug
Integer: Die Anzahl der Punkte, die eine Frage wert ist.
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab (bei einem Section manchmal auch als Überschrift bezeichnet).
Rückflug
String – der Titel oder Headertext des Elements
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements als Item ab.
Rückflug
Item: Der Typ des Artikels.
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Gibt an, ob der Befragte die Frage beantworten muss.
Rückflug
Boolean – ob der Befragte die Frage beantworten muss
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Legt das Feedback fest, das den Teilnehmern angezeigt wird, wenn sie auf eine Frage antworten, die bewertet werden kann, aber keine richtige oder falsche Antwort hat (d. h. Fragen, die manuell bewertet werden müssen).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
feedback | Quiz | das neue Feedback |
Rückflug
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie Image, Page und Section bezeichnet).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | der neue Hilfetext |
Rückflug
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Legt die Anzahl der Punkte fest, die ein bewertbares 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
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
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
Paragraph – das aktuelle Element (zum Verketten)
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (bei einem Section manchmal auch als Überschrift bezeichnet).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | den neuen Titel oder Headertext |
Rückflug
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
Legt die Datenvalidierung für dieses Absatztextelement fest. Wenn Sie null oder eine Paragraph-Instanz übergeben, für die keine „require“-Funktionen aufgerufen wurden, wird die vorherige Validierung entfernt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
validation | Paragraph | eine ParagraphTextValidation, die auf dieses Element angewendet werden soll. |
Rückflug
Paragraph – diese Paragraph zur Verkettung
Autorisierung
Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms