REST Resource: forms

{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string
}

string

Nur Ausgabe Die Formular-ID.

object (Info)

Erforderlich. Titel und Beschreibung des Formulars.

object (FormSettings)

Formulareinstellungen Dies muss mit UpdateSettingsRequest aktualisiert werden. Er wird während forms.create und UpdateFormInfoRequest ignoriert.

object (Item)

Erforderlich. Eine Liste der Formularelemente, die z. B. Abschnittsüberschriften, Fragen oder eingebettete Medien enthalten kann.

string

Nur Ausgabe Die Überarbeitungs-ID des Formulars. Wird in WriteControl in Aktualisierungsanfragen verwendet, um die Überarbeitung zu identifizieren, auf der die Änderungen basieren.

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.

string

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.

string

Nur Ausgabe Die ID der verknüpften Google-Tabelle, in der Antworten aus diesem Formular erfasst werden (sofern eine solche Tabelle vorhanden ist).

{
  "title": string,
  "documentTitle": string,
  "description": string
}

string

Erforderlich. Titel des Formulars, der für die Teilnehmer sichtbar ist

string

Nur Ausgabe Der in Google Drive sichtbare Titel des Dokuments. Wenn Info.title leer ist, wird möglicherweise documentTitle an seiner Stelle in der Google Formulare-Benutzeroberfläche angezeigt und ist für die Teilnehmer sichtbar. documentTitle kann beim Erstellen festgelegt, aber nicht durch eine BatchUpdate-Anfrage geändert werden. Verwenden Sie die Google Drive API, wenn Sie documentTitle programmatisch aktualisieren müssen.

string

Die Beschreibung des Formulars.

{
  "quizSettings": {
    object (QuizSettings)
  }
}

object (QuizSettings)

Einstellungen für Quizformulare und Benotung.

{
  "isQuiz": boolean
}

boolean

Gibt an, ob dieses Formular ein Quiz ist oder nicht. Bei „true“ werden die Antworten auf Grundlage der Frage Grading benotet. Wird sie auf „false“ gesetzt, werden alle Fragen Grading gelöscht.

{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}

string

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.

string

Der Titel des Artikels.

string

Die Beschreibung des Artikels

object (QuestionItem)

Dem Nutzer wird eine Frage gestellt.

object (QuestionGroupItem)

Sie stellen dem Nutzer eine oder mehrere Fragen mit einer einzigen Hauptaufforderung.

object (PageBreakItem)

Startet eine neue Seite mit einem Titel.

object (TextItem)

Auf der Seite werden ein Titel und eine Beschreibung angezeigt.

object (ImageItem)

Zeigt ein Bild auf der Seite an.

object (VideoItem)

Zeigt ein Video auf der Seite an.

{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}

object (Question)

Erforderlich. Die angezeigte Frage.

object (Image)

Das in der Frage angezeigte Bild.

{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  }
  // End of list of possible types for union field kind.
}

string

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.

boolean

Gibt an, ob die Frage beantwortet werden muss, damit ein Teilnehmer seine Antwort senden kann.

object (Grading)

Benotungseinrichtung für die Frage.

object (ChoiceQuestion)

Teilnehmer können aus vordefinierten Optionen wählen.

object (TextQuestion)

Der Teilnehmer kann eine kostenlose Textantwort eingeben.

object (ScaleQuestion)

Der Teilnehmer kann eine Zahl aus einem Bereich auswählen.

object (DateQuestion)

Der Befragte kann ein Datum eingeben.

object (TimeQuestion)

Der Befragte kann eine Uhrzeit eingeben.

object (FileUploadQuestion)

Ein Befragter kann eine oder mehrere Dateien hochladen.

object (RowQuestion)

Eine Zeile von einem QuestionGroupItem.

{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}

enum (ChoiceType)

Erforderlich. Die Art der Auswahlfrage.

object (Option)

Erforderlich. Liste der Optionen, aus denen ein Befragter auswählen muss.

boolean

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.

{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}

string

Erforderlich. Die Auswahl, die dem Nutzer angezeigt wird.

object (Image)

Bild als Option anzeigen.

boolean

Gibt an, ob die Option „Sonstiges“ ist. Gilt derzeit nur für die Auswahltypen RADIO und CHECKBOX, ist aber in einem QuestionGroupItem nicht zulässig.

enum (GoToAction)

Navigationstyp für den Abschnitt.

string

Artikel-ID der Abschnittsüberschrift, zu der weitergeleitet werden soll.

{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}

string

Nur Ausgabe URI, von dem Sie das Bild herunterladen können. Dieser URI ist nur für begrenzte Zeit gültig.

string

Eine Beschreibung des Bildes, die von Screenreadern vorgelesen wird, wenn der Mauszeiger darauf bewegt wird.

object (MediaProperties)

Eigenschaften eines Bildes.

string

Nur Eingabe. Der Quell-URI ist der URI, mit dem das Bild eingefügt wird. Der Quell-URI kann beim Abrufen leer sein.

{
  "alignment": enum (Alignment),
  "width": integer
}

enum (Alignment)

Die Position des Mediums.

integer

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.

{
  "paragraph": boolean
}

boolean

Ob es sich um eine Absatzfrage handelt oder nicht Falls nicht, ist die Frage eine kurze Textfrage.

{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}

integer

Erforderlich. Der niedrigste mögliche Wert für die Skala.

integer

Erforderlich. Der höchstmögliche Wert für die Skala.

string

Die anzuzeigende Beschriftung zur Beschreibung des niedrigsten Punkts auf der Waage.

string

Die anzuzeigende Beschriftung, die den höchsten Punkt auf der Skala beschreibt.

{
  "includeTime": boolean,
  "includeYear": boolean
}

boolean

Gibt an, ob die Uhrzeit in die Frage aufgenommen werden soll.

boolean

Gibt an, ob das Jahr bei der Frage berücksichtigt werden soll.

{
  "duration": boolean
}

boolean

true, wenn sich die Frage auf eine verstrichene Zeit bezieht. Andernfalls ist es nur die Tageszeit.

{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}

string

Erforderlich. Die ID des Drive-Ordners, in dem die hochgeladenen Dateien gespeichert sind.

enum (FileType)

Für diese Frage akzeptierte Dateitypen.

integer

Maximale Anzahl von Dateien, die für diese Frage in einer Antwort hochgeladen werden können.

string (int64 format)

Maximal zulässige Anzahl von Byte für eine einzelne Datei, die zu dieser Frage hochgeladen wird.

{
  "title": string
}

string

Erforderlich. Der Titel für die einzelne Zeile im QuestionGroupItem.

{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}

integer

Erforderlich. Die maximale Punktzahl, die ein Teilnehmer automatisch für eine richtige Antwort erhalten kann. Dieser Wert darf nicht negativ sein.

object (CorrectAnswers)

Erforderlich. Der Antwortschlüssel für die Frage. Die Antworten werden automatisch anhand dieses Felds benotet.

object (Feedback)

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.

object (Feedback)

Das Feedback, das für falsche Antworten angezeigt wurde. Dieses Feedback kann nur für Multiple-Choice-Fragen verwendet werden, die richtige Antworten haben.

object (Feedback)

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.

{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}

object (CorrectAnswer)

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 (CHECKBOX) wird eine Antwort als richtig markiert, wenn sie genau die Werte in dieser Liste enthält.

{
  "value": string
}

string

Erforderlich. Den richtigen Antwortwert. Weitere Informationen zur Formatierung verschiedener Werttypen finden Sie in der Dokumentation zu TextAnswer.value.

{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}

object (Question)

Erforderlich. Eine Liste mit Fragen, die zu dieser Fragengruppe gehören. Eine Frage darf nur zu einer Gruppe gehören. Die kind der Gruppe können beeinflussen, welche Arten von Fragen erlaubt sind.

object (Image)

Das Bild, das in der Fragengruppe über den jeweiligen Fragen angezeigt wird.

object (Grid)

Die Fragengruppe ist ein Raster mit Zeilen von Multiple-Choice-Fragen, die die gleichen Optionen haben. Wenn grid festgelegt ist, müssen alle Fragen in der Gruppe vom Typ row sein.

{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}

object (ChoiceQuestion)

Erforderlich. Die Auswahlmöglichkeiten für jede Frage in der Matrix. Mit anderen Worten, die Werte der Spalten. Es sind nur CHECK_BOX- und RADIO-Optionen zulässig.

boolean

Bei true werden die Fragen zufällig angeordnet. Die Zeilen erscheinen also für jeden Befragten in einer anderen Reihenfolge.

{
  "image": {
    object (Image)
  }
}

object (Image)

Erforderlich. Das im Element angezeigte Bild

{
  "video": {
    object (Video)
  },
  "caption": string
}

object (Video)

Erforderlich. Das im Element angezeigte Video

string

Der Text, der unter dem Video angezeigt wird.

{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}

string

Erforderlich. Eine YouTube-URI.

object (MediaProperties)

Eigenschaften eines Videos.