- Ressource: Formular
- Informationen
- FormSettings
- QuizSettings
- Element
- QuestionItem
- Frage
- ChoiceQuestion
- ChoiceType
- Option
- GoToAction
- Bild
- MediaProperties
- Ausrichtung
- TextQuestion
- ScaleQuestion
- DateQuestion
- TimeQuestion
- FileUploadQuestion
- FileType
- RowQuestion
- Benotung
- CorrectAnswers
- CorrectAnswer
- QuestionGroupItem
- Raster
- PageBreakItem
- TextItem
- ImageItem
- VideoItem
- Video
- Methoden
Ressource: Form
Ein Google Formulare-Dokument. Ein Formular wird in Google Drive erstellt. Das Löschen oder Ändern des Zugriffsschutzes erfolgt über die Drive API.
JSON-Darstellung |
---|
{ "formId": string, "info": { object ( |
Felder | |
---|---|
formId |
Nur Ausgabe Die Formular-ID. |
info |
Erforderlich. Titel und Beschreibung des Formulars. |
settings |
Formulareinstellungen Dies muss mit |
items[] |
Erforderlich. Eine Liste der Formularelemente, die z. B. Abschnittsüberschriften, Fragen oder eingebettete Medien enthalten kann. |
revisionId |
Nur Ausgabe Die Überarbeitungs-ID des Formulars. Wird in Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Daher sollte sie undurchsichtig behandelt werden. Eine zurückgegebene Überarbeitungs-ID ist nach der Rückgabe nur 24 Stunden lang gültig und kann nicht für andere Nutzer freigegeben werden. Wenn die Überarbeitungs-ID zwischen den Aufrufen unverändert bleibt, hat sich das Formular nicht geändert. Umgekehrt bedeutet eine geänderte ID (für dasselbe Formular und denselben Nutzer) in der Regel, dass das Formular aktualisiert wurde. Eine geänderte ID kann jedoch auch auf interne Faktoren wie Änderungen am ID-Format zurückzuführen sein. |
responderUri |
Nur Ausgabe Der Formular-URI, der für die Teilnehmer freigegeben werden soll. Daraufhin wird eine Seite geöffnet, auf der der Nutzer Antworten senden, aber die Fragen nicht bearbeiten kann. |
linkedSheetId |
Nur Ausgabe Die ID der verknüpften Google-Tabelle, in der Antworten aus diesem Formular erfasst werden (sofern eine solche Tabelle vorhanden ist). |
Info
Die allgemeinen Informationen zu einem Formular.
JSON-Darstellung |
---|
{ "title": string, "documentTitle": string, "description": string } |
Felder | |
---|---|
title |
Erforderlich. Titel des Formulars, der für die Teilnehmer sichtbar ist |
documentTitle |
Nur Ausgabe Der in Google Drive sichtbare Titel des Dokuments. Wenn |
description |
Die Beschreibung des Formulars. |
FormSettings
Die Einstellungen eines Formulars.
JSON-Darstellung |
---|
{
"quizSettings": {
object ( |
Felder | |
---|---|
quizSettings |
Einstellungen für Quizformulare und Benotung. |
QuizSettings
Einstellungen für Quizformulare und Benotung. Diese müssen mit „UpdateSettingsRequest“ aktualisiert werden.
JSON-Darstellung |
---|
{ "isQuiz": boolean } |
Felder | |
---|---|
isQuiz |
Gibt an, ob dieses Formular ein Quiz ist oder nicht. Bei „true“ werden die Antworten auf Grundlage der Frage |
Element
Ein einzelnes Element des Formulars. kind
definiert, um welche Art von Element es sich handelt.
JSON-Darstellung |
---|
{ "itemId": string, "title": string, "description": string, // Union field |
Felder | |
---|---|
itemId |
Die Artikel-ID. Sie kann bei der Erstellung angegeben werden, darf aber nicht bereits im Formular verwendet werden. Wenn nicht angegeben, wird eine neue ID zugewiesen. |
title |
Der Titel des Artikels. |
description |
Die Beschreibung des Artikels |
Union-Feld kind . Erforderlich. Dies ist die Art des Elements. kind kann nur einer der folgenden Werte sein: |
|
questionItem |
Dem Nutzer wird eine Frage gestellt. |
questionGroupItem |
Sie stellen dem Nutzer eine oder mehrere Fragen mit einer einzigen Hauptaufforderung. |
pageBreakItem |
Startet eine neue Seite mit einem Titel. |
textItem |
Auf der Seite werden ein Titel und eine Beschreibung angezeigt. |
imageItem |
Zeigt ein Bild auf der Seite an. |
videoItem |
Zeigt ein Video auf der Seite an. |
QuestionItem
Ein Formularelement, das eine einzelne Frage enthält.
JSON-Darstellung |
---|
{ "question": { object ( |
Felder | |
---|---|
question |
Erforderlich. Die angezeigte Frage. |
image |
Das in der Frage angezeigte Bild. |
Frage
Beliebige Frage. Der spezifische Fragetyp ist durch seine kind
bekannt.
JSON-Darstellung |
---|
{ "questionId": string, "required": boolean, "grading": { object ( |
Felder | |
---|---|
questionId |
Schreibgeschützt. Die Frage-ID. Sie kann bei der Erstellung angegeben werden, darf aber nicht bereits im Formular verwendet werden. Wenn nicht angegeben, wird eine neue ID zugewiesen. |
required |
Gibt an, ob die Frage beantwortet werden muss, damit ein Teilnehmer seine Antwort senden kann. |
grading |
Benotungseinrichtung für die Frage. |
Union-Feld kind . Erforderlich. Die Art der Frage, die einem Teilnehmer angeboten wird. Für kind ist nur einer der folgenden Werte zulässig: |
|
choiceQuestion |
Teilnehmer können aus vordefinierten Optionen wählen. |
textQuestion |
Der Teilnehmer kann eine kostenlose Textantwort eingeben. |
scaleQuestion |
Der Teilnehmer kann eine Zahl aus einem Bereich auswählen. |
dateQuestion |
Der Befragte kann ein Datum eingeben. |
timeQuestion |
Der Befragte kann eine Uhrzeit eingeben. |
fileUploadQuestion |
Ein Befragter kann eine oder mehrere Dateien hochladen. |
rowQuestion |
Eine Zeile von einem |
ChoiceQuestion
Eine Frage mit einem Optionsfeld oder einem Drop-down-Menü
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type |
Erforderlich. Die Art der Auswahlfrage. |
options[] |
Erforderlich. Liste der Optionen, aus denen ein Befragter auswählen muss. |
shuffle |
Gibt an, ob die Optionen für verschiedene Instanzen des Quiz in zufälliger Reihenfolge angezeigt werden sollen. Dies wird häufig verwendet, um Betrug von Befragten zu verhindern, die möglicherweise auf den Bildschirm eines anderen Teilnehmers schauen, oder um Voreingenommenheiten in einer Umfrage zu vermeiden, die möglicherweise eingeführt wird, indem immer die gleichen Optionen an erster oder letzter Stelle angezeigt werden. |
ChoiceType
Die Art der Auswahl.
Enums | |
---|---|
CHOICE_TYPE_UNSPECIFIED |
Standardwert nicht in Verwendung. |
RADIO |
Optionsfelder: Der Nutzer sieht alle Optionen, sodass er nur eine auswählen kann. |
CHECKBOX |
Kästchen: Der Nutzer sieht alle Auswahlmöglichkeiten und kann eine beliebige Anzahl auswählen. |
DROP_DOWN |
Drop-down-Menü: Die Auswahlmöglichkeiten werden dem Nutzer nur bei Bedarf angezeigt, andernfalls wird nur die aktuelle Auswahl angezeigt. Es kann nur eine Option ausgewählt werden. |
Option
Eine Option für eine Choice-Frage.
JSON-Darstellung |
---|
{ "value": string, "image": { object ( |
Felder | |
---|---|
value |
Erforderlich. Die Auswahl, die dem Nutzer angezeigt wird. |
image |
Bild als Option anzeigen. |
isOther |
Gibt an, ob die Option „Sonstiges“ ist. Gilt derzeit nur für die Auswahltypen |
Union-Feld go_to_section . Bereich, zu dem gewechselt werden soll, wenn diese Option ausgewählt wird. Gilt derzeit nur für den Auswahltyp RADIO und SELECT , ist aber in einem QuestionGroupItem nicht zulässig. Für go_to_section ist nur einer der folgenden Werte zulässig: |
|
goToAction |
Navigationstyp für den Abschnitt. |
goToSectionId |
Artikel-ID der Abschnittsüberschrift, zu der weitergeleitet werden soll. |
GoToAction
Konstanten für die Abschnittsnavigation
Enums | |
---|---|
GO_TO_ACTION_UNSPECIFIED |
Standardwert nicht in Verwendung. |
NEXT_SECTION |
Wechseln Sie zum nächsten Abschnitt. |
RESTART_FORM |
Gehen Sie zurück zum Anfang des Formulars. |
SUBMIT_FORM |
Senden Sie das Formular sofort ab. |
Bild
Daten, die ein Bild darstellen.
JSON-Darstellung |
---|
{ "contentUri": string, "altText": string, "properties": { object ( |
Felder | |
---|---|
contentUri |
Nur Ausgabe URI, von dem Sie das Bild herunterladen können. Dieser URI ist nur für begrenzte Zeit gültig. |
altText |
Eine Beschreibung des Bildes, die von Screenreadern vorgelesen wird, wenn der Mauszeiger darauf bewegt wird. |
properties |
Eigenschaften eines Bildes. |
Union-Feld image_source . Die Art der Bildquelle. Beim Erstellen neuer Bilder muss genau ein Bildquellenfeld festgelegt werden. Für image_source ist nur einer der folgenden Werte zulässig: |
|
sourceUri |
Nur Eingabe. Der Quell-URI ist der URI, mit dem das Bild eingefügt wird. Der Quell-URI kann beim Abrufen leer sein. |
MediaProperties
Eigenschaften des Mediums.
JSON-Darstellung |
---|
{
"alignment": enum ( |
Felder | |
---|---|
alignment |
Die Position des Mediums. |
width |
Die Breite des Mediums in Pixeln. Wenn das Medium angezeigt wird, wird es auf den kleineren Wert oder auf die Breite des angezeigten Formulars skaliert. Das ursprüngliche Seitenverhältnis der Medien wird beibehalten. Wenn beim Hinzufügen des Mediums zum Formular keine Breite angegeben wird, wird sie auf die Breite der Medienquelle festgelegt. Die Breite muss zwischen 0 und 740 liegen. Das Festlegen der Breite auf „0“ oder „Nicht angegeben“ ist nur beim Aktualisieren der Medienquelle zulässig. |
Ausrichtung
Ausrichtung auf der Seite.
Enums | |
---|---|
ALIGNMENT_UNSPECIFIED |
Standardwert nicht in Verwendung. |
LEFT |
Linksbündig. |
RIGHT |
Rechtsbündig. |
CENTER |
Mitte. |
TextQuestion
Eine textbasierte Frage.
JSON-Darstellung |
---|
{ "paragraph": boolean } |
Felder | |
---|---|
paragraph |
Ob es sich um eine Absatzfrage handelt oder nicht Falls nicht, ist die Frage eine kurze Textfrage. |
ScaleQuestion
Eine Skala-Frage. Der Nutzer kann aus einem Bereich numerischer Werte auswählen.
JSON-Darstellung |
---|
{ "low": integer, "high": integer, "lowLabel": string, "highLabel": string } |
Felder | |
---|---|
low |
Erforderlich. Der niedrigste mögliche Wert für die Skala. |
high |
Erforderlich. Der höchstmögliche Wert für die Skala. |
lowLabel |
Die anzuzeigende Beschriftung zur Beschreibung des niedrigsten Punkts auf der Waage. |
highLabel |
Die anzuzeigende Beschriftung, die den höchsten Punkt auf der Skala beschreibt. |
DateQuestion
Eine Datumsfrage. Bei Datumsfragen werden standardmäßig nur Monat und Tag angezeigt.
JSON-Darstellung |
---|
{ "includeTime": boolean, "includeYear": boolean } |
Felder | |
---|---|
includeTime |
Gibt an, ob die Uhrzeit in die Frage aufgenommen werden soll. |
includeYear |
Gibt an, ob das Jahr bei der Frage berücksichtigt werden soll. |
TimeQuestion
Eine Zeitfrage.
JSON-Darstellung |
---|
{ "duration": boolean } |
Felder | |
---|---|
duration |
|
FileUploadQuestion
Eine Frage zum Dateiupload. Das Erstellen von Fragen zum Dateiupload wird von der API derzeit nicht unterstützt.
JSON-Darstellung |
---|
{
"folderId": string,
"types": [
enum ( |
Felder | |
---|---|
folderId |
Erforderlich. Die ID des Drive-Ordners, in dem die hochgeladenen Dateien gespeichert sind. |
types[] |
Für diese Frage akzeptierte Dateitypen. |
maxFiles |
Maximale Anzahl von Dateien, die für diese Frage in einer Antwort hochgeladen werden können. |
maxFileSize |
Maximal zulässige Anzahl von Byte für eine einzelne Datei, die zu dieser Frage hochgeladen wird. |
FileType
Dateitypen, die für eine Frage zum Hochladen von Dateien hochgeladen werden können
Enums | |
---|---|
FILE_TYPE_UNSPECIFIED |
Standardwert nicht in Verwendung. |
ANY |
Keine Einschränkungen für den Typ. |
DOCUMENT |
Ein Google Docs-Dokument. |
PRESENTATION |
Eine Google-Präsentation |
SPREADSHEET |
Eine Tabelle in Google Tabellen. |
DRAWING |
Eine Zeichnung. |
PDF |
Als PDF-Datei |
IMAGE |
Ein Bild. |
VIDEO |
Ein Video. |
AUDIO |
Eine Audiodatei. |
RowQuestion
Konfiguration für eine Frage, die Teil einer Fragengruppe ist.
JSON-Darstellung |
---|
{ "title": string } |
Felder | |
---|---|
title |
Erforderlich. Der Titel für die einzelne Zeile im |
Benotung
Benotung einer einzelnen Frage
JSON-Darstellung |
---|
{ "pointValue": integer, "correctAnswers": { object ( |
Felder | |
---|---|
pointValue |
Erforderlich. Die maximale Punktzahl, die ein Teilnehmer automatisch für eine richtige Antwort erhalten kann. Dieser Wert darf nicht negativ sein. |
correctAnswers |
Erforderlich. Der Antwortschlüssel für die Frage. Die Antworten werden automatisch anhand dieses Felds benotet. |
whenRight |
Das Feedback, das für die richtigen Antworten angezeigt wurde. Dieses Feedback kann nur für Multiple-Choice-Fragen verwendet werden, die richtige Antworten haben. |
whenWrong |
Das Feedback, das für falsche Antworten angezeigt wurde. Dieses Feedback kann nur für Multiple-Choice-Fragen verwendet werden, die richtige Antworten haben. |
generalFeedback |
Das Feedback, das für alle Antworten angezeigt wurde. Diese Option wird häufig für Kurzantwort-Fragen verwendet, wenn der Besitzer eines Quiz den Befragten schnell einen Eindruck davon vermitteln möchte, ob sie die Frage richtig beantwortet haben, bevor sie die Antwort offiziell benoten können. Für automatisch benotete Multiple-Choice-Fragen kann kein allgemeines Feedback festgelegt werden. |
CorrectAnswers
Der Antwortschlüssel für eine Frage.
JSON-Darstellung |
---|
{
"answers": [
{
object ( |
Felder | |
---|---|
answers[] |
Eine Liste richtiger Antworten. Quizantworten können anhand dieser Antworten automatisch benotet werden. Bei einwertigen Fragen wird eine Antwort als richtig markiert, wenn sie mit einem Wert in dieser Liste übereinstimmt. Es sind also mehrere richtige Antworten möglich. Bei mehrwertigen Fragen ( |
CorrectAnswer
Eine einzelne richtige Antwort auf eine Frage. Bei mehrwertigen Fragen (CHECKBOX
) sind möglicherweise mehrere CorrectAnswer
s erforderlich, um eine einzelne richtige Antwortoption darzustellen.
JSON-Darstellung |
---|
{ "value": string } |
Felder | |
---|---|
value |
Erforderlich. Den richtigen Antwortwert. Weitere Informationen zur Formatierung verschiedener Werttypen finden Sie in der Dokumentation zu |
QuestionGroupItem
Definiert eine Frage, die aus mehreren gruppierten Fragen besteht.
JSON-Darstellung |
---|
{ "questions": [ { object ( |
Felder | |
---|---|
questions[] |
Erforderlich. Eine Liste mit Fragen, die zu dieser Fragengruppe gehören. Eine Frage darf nur zu einer Gruppe gehören. Die |
image |
Das Bild, das in der Fragengruppe über den jeweiligen Fragen angezeigt wird. |
Union-Feld kind . Erforderlich. Der Typ der Fragengruppe, durch den festgelegt wird, welche Arten von Fragen zulässig sind und wie sie angezeigt werden. Für kind ist nur einer der folgenden Werte zulässig: |
|
grid |
Die Fragengruppe ist ein Raster mit Zeilen von Multiple-Choice-Fragen, die die gleichen Optionen haben. Wenn |
Raster
Ein Raster mit Auswahlmöglichkeiten (Radio- oder Kontrollkästchen), wobei jede Zeile eine separate Frage darstellt. Jede Zeile hat die gleichen Auswahlmöglichkeiten, die wie die Spalten angezeigt werden.
JSON-Darstellung |
---|
{
"columns": {
object ( |
Felder | |
---|---|
columns |
Erforderlich. Die Auswahlmöglichkeiten für jede Frage in der Matrix. Mit anderen Worten, die Werte der Spalten. Es sind nur |
shuffleQuestions |
Bei |
PageBreakItem
Ein Seitenumbruch. Titel und Beschreibung dieses Elements werden oben auf der neuen Seite angezeigt.
TextItem
Ein Textelement.
ImageItem
Ein Element, das ein Bild enthält.
JSON-Darstellung |
---|
{
"image": {
object ( |
Felder | |
---|---|
image |
Erforderlich. Das im Element angezeigte Bild |
VideoItem
Ein Element, das ein Video enthält.
JSON-Darstellung |
---|
{
"video": {
object ( |
Felder | |
---|---|
video |
Erforderlich. Das im Element angezeigte Video |
caption |
Der Text, der unter dem Video angezeigt wird. |
Video
Daten, die ein Video darstellen.
JSON-Darstellung |
---|
{
"youtubeUri": string,
"properties": {
object ( |
Felder | |
---|---|
youtubeUri |
Erforderlich. Eine YouTube-URI. |
properties |
Eigenschaften eines Videos. |
Methoden |
|
---|---|
|
Ändern Sie das Formular mit einem Batch von Aktualisierungen. |
|
Erstellen Sie ein neues Formular mit dem Titel aus der Formularnachricht in der Anfrage. |
|
Formular abrufen. |