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
clear Validation()
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
create Response(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
get General Feedback()
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
get Help Text()
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
get Id()
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
get Index()
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
get Points()
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
get Title()
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
get Type()
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
is Required()
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
set General Feedback(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
set Help Text(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
set Points(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
set Required(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
set Title(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
set Validation(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