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. Der Titel und die Beschreibung des Formulars.

object (FormSettings)

Formulareinstellungen Muss mit UpdateSettingsRequest aktualisiert werden; wird während forms.create und UpdateFormInfoRequest ignoriert.

object (Item)

Erforderlich. Eine Liste der Elemente des Formulars, die Abschnittsüberschriften, Fragen, eingebettete Medien usw. 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, deshalb sollte es mit undurchsichtig behandelt werden. Eine zurückgegebene Überarbeitungs-ID ist nach der Rückgabe 24 Stunden lang gültig und kann nicht mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen Aufrufen unverändert bleibt, bleibt das Formular unverä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 aber auch durch interne Faktoren wie Änderungen des ID-Formats verursacht werden.

string

Nur Ausgabe. Der Formular-URI, der für Teilnehmer freigegeben werden soll. Daraufhin wird eine Seite geöffnet, auf der Nutzer Antworten senden, aber keine Fragen bearbeiten können.

string

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

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

string

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

string

Nur Ausgabe. Der Titel des Dokuments, das in Google Drive sichtbar ist. Wenn Info.title leer ist, kann an der Stelle in der Benutzeroberfläche von Google Formulare documentTitle angezeigt und für die Teilnehmer sichtbar sein. 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

Ob dieses Formular ein Quiz ist oder nicht. Bei „true“ werden Antworten auf Grundlage der Frage Grading benotet. Wenn Sie den Wert auf „false“ setzen, wird die Frage 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

Artikel-ID.

Beim Erstellen kann die ID angegeben werden, aber die ID darf noch nicht 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)

Dem Nutzer wird eine wichtige Frage gestellt.

object (PageBreakItem)

Öffnet eine neue Seite mit einem Titel.

object (TextItem)

Titel und Beschreibung der Seite anzeigen

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)

Bild, das in der Frage angezeigt wird

{
  "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 ID der Frage.

Beim Erstellen kann die ID angegeben werden, aber die ID darf noch nicht im Formular verwendet werden. Wenn nicht angegeben, wird eine neue ID zugewiesen.

boolean

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

object (Grading)

Einrichtung der Benotung für die Frage

object (ChoiceQuestion)

Der Teilnehmer hat die Wahl zwischen vordefinierten Optionen.

object (TextQuestion)

Teilnehmer können eine Freitextantwort eingeben.

object (ScaleQuestion)

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

object (DateQuestion)

Ein Teilnehmer kann ein Datum eingeben.

object (TimeQuestion)

Ein Teilnehmer kann eine Uhrzeit eingeben.

object (FileUploadQuestion)

Ein Teilnehmer kann eine oder mehrere Dateien hochladen.

object (RowQuestion)

Eine Zeile mit einer 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 Teilnehmer auswählen muss.

boolean

Gibt an, ob die Optionen für verschiedene Instanzen des Quiz in zufälliger Reihenfolge angezeigt werden sollen. Damit wird häufig verhindert, dass Betrüger beleidigt werden, die auf den Bildschirm eines anderen Teilnehmers blicken, oder um Verzerrungen in einer Umfrage zu beseitigen, die durch das direkte Bewerten derselben Optionen entstehen.

{
  "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 präsentiert 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 QuestionGroupItem nicht zulässig.

enum (GoToAction)

Typ der Abschnittsnavigation.

string

Element-ID der Abschnittsüberschrift, zu der er 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. Ein URI, von dem Sie das Bild herunterladen können. Dieser ist nur für begrenzte Zeit gültig.

string

Eine Beschreibung des Bildes, das von Screenreadern angezeigt wird, wenn der Mauszeiger darauf bewegt wird.

object (MediaProperties)

Eigenschaften eines Bilds.

string

Nur Eingabe. Der Quell-URI ist der URI zum Einfügen des Bildes. Der Quell-URI kann beim Abrufen leer sein.

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

enum (Alignment)

Position des Mediums.

integer

Breite des Mediums in Pixeln Wenn das Medium angezeigt wird, wird es auf den kleineren Wert oder die Breite des angezeigten Formulars skaliert. Das ursprüngliche Seitenverhältnis des Medien bleibt erhalten. Wenn beim Hinzufügen des Mediums keine Breite angegeben ist, wird die Breite der Medienquelle festgelegt. Die Breite muss zwischen 0 und 740 liegen. Das Festlegen einer Breite auf „0“ oder nicht angegeben ist nur beim Aktualisieren der Medienquelle zulässig.

{
  "paragraph": boolean
}

boolean

Gibt an, ob die Frage ein Absatz ist. Wenn nicht, ist die Frage eine kurze Frage.

{
  "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 Waage.

string

Das anzuzeigende Label, das den niedrigsten Punkt auf der Skala beschreibt.

string

Das anzuzeigende Label, das den höchsten Punkt auf der Skala beschreibt.

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

boolean

Gibt an, ob die Zeit als Teil der Frage verwendet 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. Ansonsten ist es eine Tageszeit.

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

string

Erforderlich. Die ID des Google Drive-Ordners, in dem hochgeladene Dateien gespeichert sind.

enum (FileType)

Von dieser Frage akzeptierte Dateitypen.

integer

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

string (int64 format)

Maximal zulässige Anzahl von Byte für jede einzelne Datei, die in diese Frage hochgeladen wird.

{
  "title": string
}

string

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

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

integer

Erforderlich. Die maximale Anzahl von Punkten, 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 anhand dieses Feldes automatisch benotet.

object (Feedback)

Das Feedback für richtige Antworten. Dieses Feedback kann nur für Multiple-Choice-Fragen mit den richtigen Antworten festgelegt werden.

object (Feedback)

Das Feedback, das für falsche Antworten angezeigt wird. Dieses Feedback kann nur für Multiple-Choice-Fragen mit den richtigen Antworten festgelegt werden.

object (Feedback)

Das Feedback, das für alle Antworten angezeigt wird. Dies wird häufig bei Kurzantwort-Fragen verwendet, wenn der Inhaber des Quiz den Teilnehmern schnell zeigen möchte, ob er die Frage richtig beantwortet hat, bevor er die Antwort offiziell bewerten konnte. Für automatisch benotete Multiple-Choice-Fragen kann kein allgemeines Feedback festgelegt werden.

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

object (CorrectAnswer)

Eine Liste mit den richtigen Antworten. Eine Quizantwort kann automatisch benotet werden. Bei Fragen mit einem Wert wird eine Antwort als richtig markiert, wenn sie mit einem Wert in dieser Liste übereinstimmt (d. h., es sind mehrere richtige Antworten möglich). Bei Fragen mit mehreren Werten (CHECKBOX) wird eine Antwort als korrekt markiert, wenn sie genau die Werte in dieser Liste enthält.

{
  "value": string
}

string

Erforderlich. Der richtige 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 Fragegruppe gehören. Eine Frage darf nur zu einer Gruppe gehören. Die kind der Gruppe beeinflusst, welche Fragen zulässig sind.

object (Image)

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

object (Grid)

Die Fragengruppe ist ein Raster mit Zeilen mit Multiple-Choice-Fragen mit denselben Optionen. Wenn grid festgelegt ist, müssen alle Fragen in der Gruppe den Typ row haben.

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

object (ChoiceQuestion)

Erforderlich. Die Auswahl, die bei jeder Frage im Raster geteilt wird. Das heißt, die Werte der Spalten. Es sind nur CHECK_BOX und RADIO Optionen zulässig.

boolean

Wenn true, werden die Fragen nach dem Zufallsprinzip sortiert. Die Zeilen werden also für jeden Teilnehmer in einer anderen Reihenfolge angezeigt.

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

object (Image)

Erforderlich. Das im Artikel angezeigte Bild

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

object (Video)

Erforderlich. Das im Artikel angezeigte Video

string

Der Text, der unter dem Video angezeigt wird.

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

string

Erforderlich. Ein YouTube-URI.

object (MediaProperties)

Eigenschaften eines Videos.