Class DurationItem

DurationItem

Ein Frageelement, mit dem der Teilnehmer eine Zeitspanne angeben kann. Auf Elemente kann über ein Form zugegriffen oder sie können darüber erstellt werden. Wenn diese Elemente in einem Quiz verwendet werden, werden sie bewertet. 

// Open a form by ID and add a new duration item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDurationItem();
item.setTitle('How long can you hold your breath?');

Methoden

MethodeRückgabetypKurzbeschreibung
createResponse(hours, minutes, seconds)ItemResponseErstellt ein neues ItemResponse für dieses Datumselement.
duplicate()DurationItemErstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.
getGeneralFeedback()QuizFeedback|nullGibt das Feedback zurück, das den Teilnehmern angezeigt wird, wenn sie auf eine benotbare Frage antworten.
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getPoints()IntegerGibt den Punktwert eines bewertbaren Elements zurück.
getTitle()StringRuft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Header-Text bezeichnet).
getType()ItemTypeRuft den Typ des Elements als ItemType ab.
isRequired()BooleanGibt an, ob der Befragte die Frage beantworten muss.
setGeneralFeedback(feedback)DurationItemLegt 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).
setHelpText(text)DurationItemLegt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setPoints(points)DurationItemLegt die Anzahl der Punkte fest, die ein bewertbares Element wert ist.
setRequired(enabled)DurationItemLegt fest, ob der Befragte die Frage beantworten muss.
setTitle(title)DurationItemLegt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Detaillierte Dokumentation

createResponse(hours, minutes, seconds)

Erstellt ein neues ItemResponse für dieses Datumselement. Die Argumente hours, minutes und seconds werden am besten als Ganzzahlen von 0 bis 72 für hours und von 0 bis 59 für minutes und seconds dargestellt. Werte, die diese Grenzen überschreiten, werden begrenzt. 24, 60, 90 wird beispielsweise als 24:59:59 interpretiert.

Parameter

NameTypBeschreibung
hoursIntegerDie Stunden, dargestellt als Ganzzahl von 0 bis 72
minutesIntegerdie Minuten, dargestellt als Ganzzahl von 0 bis 59
secondsIntegerdie Sekunden, dargestellt als Ganzzahl von 0 bis 59

Rückflug

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

DurationItem – ein Duplikat dieses DurationItem 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

QuizFeedback|null – das Feedback, sofern 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 ImageItems, PageBreakItems und SectionHeaderItems 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 SectionHeaderItem manchmal auch als Header-Text 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 ItemType ab.

Rückflug

ItemType: 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

NameTypBeschreibung
feedbackQuizFeedbackdas neue Feedback

Rückflug

DurationItem – diese DurationItem 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 ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

NameTypBeschreibung
textStringder neue Hilfetext

Rückflug

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

NameTypBeschreibung
pointsIntegerdie Anzahl der Punkte, die eine Frage wert ist

Rückflug

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

NameTypBeschreibung
enabledBooleanob der Befragte die Frage beantworten muss

Rückflug

DurationItem – 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 SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

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