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)

Die Einstellungen des Formulars. Dieser Wert muss mit UpdateSettingsRequest aktualisiert werden. Bei forms.create und UpdateFormInfoRequest wird er ignoriert.

object (Item)

Erforderlich. Eine Liste der Elemente des Formulars, z. B. Abschnittsüberschriften, Fragen und eingebettete Medien.

string

Nur Ausgabe. Die Überarbeitungs-ID des Formulars. Wird in Aktualisierungsanfragen im WriteControl verwendet, um die Revision anzugeben, auf der die Änderungen basieren.

Das Format der Revision-ID kann sich im Laufe der Zeit ändern. Daher sollte es nicht transparent behandelt werden. Eine zurückgegebene Versions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer verwendet werden. Wenn sich die Revision-ID zwischen den Aufrufen nicht ändert, 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. Die Formular-URI, die für Teilnehmer freigegeben werden soll. Daraufhin wird eine Seite geöffnet, auf der Nutzer Antworten einreichen, aber die Fragen nicht bearbeiten können.

string

Nur Ausgabe. Die ID der verknüpften Google-Tabelle, in der die 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, der in Drive angezeigt wird. Wenn Info.title leer ist, wird an seiner Stelle möglicherweise documentTitle in der Google Forms-Benutzeroberfläche angezeigt und ist für die Teilnehmer sichtbar. documentTitle kann beim Erstellen festgelegt werden, aber nicht durch eine BatchUpdate-Anfrage geändert werden. Verwenden Sie die Google Drive API, wenn Sie documentTitle programmgesteuert aktualisieren möchten.

string

Die Beschreibung des Formulars.

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

object (QuizSettings)

Einstellungen für Quizformulare und die Benotung.

{
  "isQuiz": boolean
}

boolean

Gibt an, ob es sich bei diesem Formular um ein Quiz handelt. Wenn diese Option aktiviert ist, werden die Antworten anhand von Frage Grading benotet. Wenn Sie „false“ festlegen, werden alle Grading-Fragen 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 beim Erstellen angegeben werden, darf aber nicht bereits im Formular verwendet werden. Wenn keine ID angegeben wird, 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 werden eine oder mehrere Fragen mit einem einzigen Hauptprompt gestellt.

object (PageBreakItem)

Startet eine neue Seite mit einem Titel.

object (TextItem)

Ein Titel und eine Beschreibung werden auf der Seite angezeigt.

object (ImageItem)

Zeigt ein Bild auf der Seite an.

object (VideoItem)

Ein Video wird auf der Seite angezeigt.

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

object (Question)

Erforderlich. Die angezeigte Frage.

object (Image)

Das 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)
  },
  "ratingQuestion": {
    object (RatingQuestion)
  }
  // End of list of possible types for union field kind.
}

string

Schreibgeschützt. Die Frage-ID.

Sie kann beim Erstellen angegeben werden, darf aber nicht bereits im Formular verwendet werden. Wenn keine ID angegeben wird, wird eine neue ID zugewiesen.

boolean

Ob die Frage beantwortet werden muss, damit ein Teilnehmer seine Antwort einreichen kann.

object (Grading)

Bewertungseinrichtung für die Frage.

object (ChoiceQuestion)

Die Befragten können aus einer Reihe von vordefinierten Optionen auswählen.

object (TextQuestion)

Die Teilnehmer können eine Freitextantwort eingeben.

object (ScaleQuestion)

Die Teilnehmer können 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 einer QuestionGroupItem.

object (RatingQuestion)

Die Befragten können eine Bewertung aus einer vordefinierten Reihe von Symbolen auswählen.

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

enum (ChoiceType)

Erforderlich. Der Typ der Auswahlfrage.

object (Option)

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

boolean

Ob die Optionen für verschiedene Instanzen des Quiz in zufälliger Reihenfolge angezeigt werden sollen. Dies wird häufig verwendet, um Betrug durch Teilnehmer zu verhindern, die auf den Bildschirm eines anderen Teilnehmers schauen, oder um Verzerrungen in einer Umfrage zu vermeiden, die durch das immer Ersteinfügen oder Letzteinfügen derselben Optionen entstehen können.

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

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 des Abschnitts.

string

Artikel-ID des Abschnittsheaders, zu dem du wechseln möchtest.

{
  "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, über den Sie das Bild herunterladen können. Dieser ist nur für eine begrenzte Zeit gültig.

string

Eine Beschreibung des Bildes, die beim Bewegen des Mauszeigers angezeigt und von Screenreadern vorgelesen wird.

object (MediaProperties)

Eigenschaften eines Bildes.

string

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

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

enum (Alignment)

Position der Medien.

integer

Die Breite des Mediums in Pixeln. Bei der Anzeige des Mediums wird es auf den kleineren Wert oder die Breite des angezeigten Formulars skaliert. Das ursprüngliche Seitenverhältnis der Medien bleibt erhalten. Wenn beim Hinzufügen von Medien zum Formular keine Breite angegeben wird, wird sie auf die Breite der Medienquelle festgelegt. Die Breite muss zwischen 0 und 740 liegen. Die Breite kann nur beim Aktualisieren der Medienquelle auf „0“ oder „nicht angegeben“ festgelegt werden.

{
  "paragraph": boolean
}

boolean

Ob es sich bei der Frage um eine Absatzfrage handelt oder nicht. Andernfalls handelt es sich um eine Frage mit kurzem Text.

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

integer

Erforderlich. Der niedrigste Wert der Skala.

integer

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

string

Das Label, das für den niedrigsten Punkt auf der Skala angezeigt werden soll.

string

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

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

boolean

Ob die Uhrzeit Teil der Frage sein soll.

boolean

Ob das Jahr in die Frage einbezogen werden soll.

{
  "duration": boolean
}

boolean

true, wenn es um einen vergangenen Zeitraum geht. Andernfalls geht es um eine Tageszeit.

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

string

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

enum (FileType)

Dateitypen, die für diese Frage zulässig sind.

integer

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

string (int64 format)

Die maximal zulässige Anzahl von Byte für eine einzelne Datei, die auf diese Frage hochgeladen wird.

{
  "title": string
}

string

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

{
  "ratingScaleLevel": integer,
  "iconType": enum (RatingIconType)
}

integer

Erforderlich. Der Wert auf der Bewertungsskala der Frage.

enum (RatingIconType)

Erforderlich. Der Symboltyp, der für die Altersfreigabe verwendet werden soll.

{
  "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. Antworten werden anhand dieses Felds automatisch benotet.

object (Feedback)

Das Feedback, das für richtige Antworten angezeigt wird. Dieses Feedback kann nur für Multiple-Choice-Fragen mit 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 richtigen Antworten festgelegt werden.

object (Feedback)

Das Feedback wird für alle Antworten angezeigt. Diese Option wird häufig bei Fragen mit Kurzantworten verwendet, wenn der Ersteller des Quiz den Teilnehmern 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 mit richtigen Antworten. Eine Quizantwort kann anhand dieser Antworten automatisch benotet werden. Bei Fragen mit nur einer Antwort wird eine Antwort als richtig markiert, wenn sie mit einem Wert in dieser Liste übereinstimmt. Mit anderen Worten: Es sind mehrere richtige Antworten möglich. Bei Fragen mit mehreren möglichen Antworten (CHECKBOX) wird eine Antwort als richtig markiert, wenn sie genau die Werte in dieser Liste enthält.

{
  "value": string
}

string

Erforderlich. Der Wert der richtigen Antwort. 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 der Fragen, die zu dieser Fragegruppe gehören. Eine Frage darf nur einer Gruppe angehören. Die kind der Gruppe kann sich darauf auswirken, welche Arten von Fragen zulässig sind.

object (Image)

Das Bild, das in der Fragegruppe über den einzelnen Fragen angezeigt wird.

object (Grid)

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

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

object (ChoiceQuestion)

Erforderlich. Die Optionen, die für jede Frage im Raster gemeinsam sind. Mit anderen Worten: die Werte der Spalten. Es sind nur CHECK_BOX und RADIO zulässig.

boolean

Bei true werden die Fragen zufällig angeordnet. Mit anderen Worten: Die Zeilen werden für jeden Teilnehmer in einer anderen Reihenfolge angezeigt.

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

object (Image)

Erforderlich. Das Bild, das im Artikel angezeigt wird.

{
  "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. Eine YouTube-URI.

object (MediaProperties)

Eigenschaften eines Videos.