Ein Frageelement, mit dem die Befragten einen Textblock eingeben können. Auf Elemente kann über eine 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 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 Textelement. |
create | Item | Erstellt ein neues Item für dieses Textelement des Absatzes. |
duplicate() | Paragraph | Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an. |
get | Quiz | Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten. |
get | String | Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie Image , Page und Section bezeichnet). |
get | Integer | Die eindeutige Kennung des Artikels. |
get | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
get | Integer | Gibt die Punktzahl eines benoteten Elements zurück. |
get | String | Der Titel des Artikels (im Fall eines Section auch als Headertext bezeichnet). |
get | Item | Der Typ des Artikels, dargestellt als Item . |
is | Boolean | Bestimmt, ob die Befragten die Frage beantworten müssen. |
set | Paragraph | 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). |
set | Paragraph | Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie Image , Page und Section auch als Beschreibungstext bezeichnet). |
set | Paragraph | Hiermit wird die Anzahl der Punkte festgelegt, die ein benotetes Element wert ist. |
set | Paragraph | Hier legen Sie fest, ob die Befragten die Frage beantworten müssen. |
set | Paragraph | Hiermit wird der Titel des Artikels festgelegt (im Fall eines Section auch als Headertext bezeichnet). |
set | Paragraph | Legt die Datenvalidierung für dieses Textelement fest. |
Detaillierte Dokumentation
clear Validation()
Entfernt die Datenvalidierung für dieses Textelement.
Rückflug
Paragraph
– dieses Paragraph
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
create Response(response)
Erstellt ein neues Item
für dieses Textelement des Absatzes.
Parameter
Name | Typ | Beschreibung |
---|---|---|
response | String | eine Antwort auf die Frage, die durch den Artikel aufgeworfen wird |
Rückflug
Item
– 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 hängt sie an das Ende des Formulars an.
Rückflug
Paragraph
– ein Duplikat dieses Paragraph
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
get General Feedback()
Gibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie eine benotete Frage beantworten.
Rückflug
Quiz
: 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
get Help Text()
Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie Image
, Page
und Section
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
get Id()
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
get Index()
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
get Points()
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
get Title()
Der Titel des Artikels (im Fall eines Section
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
get Type()
Der Typ des Artikels, dargestellt als Item
.
Rückflug
Item
: 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
is Required()
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
set General Feedback(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 | Quiz | das neue Feedback |
Rückflug
Paragraph
– dieses Paragraph
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
set Help Text(text)
Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie Image
, Page
und Section
auch als Beschreibungstext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Rückflug
Paragraph
– dieses Paragraph
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
set Points(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
Paragraph
– dieses Paragraph
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
set Required(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
Paragraph
– das aktuelle Element (für die Verknüpfung)
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
set Title(title)
Hiermit wird der Titel des Artikels festgelegt (im Fall eines Section
auch als Headertext bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Headertext |
Rückflug
Paragraph
– dieses Paragraph
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
set Validation(validation)
Legt die Datenvalidierung für dieses Textelement fest. Wenn Sie „null“ oder eine Validierung ohne Aufrufe von erforderlichen Funktionen übergeben, wird jede vorherige Validierung entfernt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
validation | Paragraph | eine ParagraphTextValidation, die auf dieses Element angewendet werden soll. |
Rückflug
Paragraph
– dieses Paragraph
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