REST Resource: forms.responses

Ressource: FormResponse

Eine Formularantwort.

JSON-Darstellung
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
Felder
formId

string

Nur Ausgabe Die Formular-ID.

responseId

string

Nur Ausgabe Die Antwort-ID.

createTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den Zeitpunkt, zu dem die Antwort zum ersten Mal gesendet wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

lastSubmittedTime

string (Timestamp format)

Nur Ausgabe Der Zeitstempel für den letzten Zeitpunkt, zu dem die Antwort gesendet wurde. Änderungen an Noten werden nicht nachverfolgt.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

respondentEmail

string

Nur Ausgabe Die E-Mail-Adresse des Befragten (falls erfasst)

answers

map (key: string, value: object (Answer))

Nur Ausgabe Die tatsächlichen Antworten auf die Fragen, angegeben nach questionId.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

totalScore

number

Nur Ausgabe Die Gesamtzahl der Punkte, die der Teilnehmer für seine Einreichung erhalten hat. Dieser Wert wird nur festgelegt, wenn das Formular ein Quiz ist und die Antwort benotet wurde. Dazu gehören auch automatisch vergebene Punkte, die durch manuelle Korrekturen vom Formularinhaber angepasst werden.

Antwort

Die eingereichte Antwort auf eine Frage.

JSON-Darstellung
{
  "questionId": string,
  "grade": {
    object (Grade)
  },

  // Union field value can be only one of the following:
  "textAnswers": {
    object (TextAnswers)
  },
  "fileUploadAnswers": {
    object (FileUploadAnswers)
  }
  // End of list of possible types for union field value.
}
Felder
questionId

string

Nur Ausgabe Die ID der Frage. Siehe auch Question.question_id.

grade

object (Grade)

Nur Ausgabe Die Note der Antwort, wenn das Formular ein Quiz war.

Union-Feld value. Die Antwort des Nutzers. Für value ist nur einer der folgenden Werte zulässig:
textAnswers

object (TextAnswers)

Nur Ausgabe Die konkreten Antworten in Textform.

fileUploadAnswers

object (FileUploadAnswers)

Nur Ausgabe Die Antworten auf eine Frage zum Dateiupload.

TextAnswers

Die Antworten auf eine Frage als Text.

JSON-Darstellung
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Felder
answers[]

object (TextAnswer)

Nur Ausgabe Antworten auf eine Frage. Bei ChoiceQuestion-Werten mit mehreren Werten ist jede Antwort ein separater Wert.

TextAnswer

Eine Antwort auf eine Frage, die als Text dargestellt wird.

JSON-Darstellung
{
  "value": string
}
Felder
value

string

Nur Ausgabe Der Antwortwert.

Formatierungen für verschiedene Arten von Fragen:

  • ChoiceQuestion
    • RADIO oder DROP_DOWN: Ein einzelner String, der der ausgewählten Option entspricht.
    • CHECKBOX: Mehrere Strings, die jeder ausgewählten Option entsprechen.
  • TextQuestion: Der vom Nutzer eingegebene Text.
  • ScaleQuestion: Ein String, der die ausgewählte Zahl enthält.
  • DateQuestion
    • Ohne Uhrzeit oder Jahr: MM-TT, z.B. "05-19"
    • Mit Jahr: JJJJ-MM-TT, z.B. "1986-05-19"
    • Mit Uhrzeit: MM-TT HH:MM, z.B. "05-19 14:51"
    • Mit Jahr und Uhrzeit: JJJJ-MM-TT HH:MM, z.B. "1986-05-19 14:51"
  • TimeQuestion: String mit Zeit oder Dauer im Format HH:MM, z.B. „14:51“
  • RowQuestion in QuestionGroupItem: Die Antwort für jede Zeile einer QuestionGroupItem wird als separate Answer dargestellt. Jede Option enthält einen String für Auswahlmöglichkeiten vom Typ RADIO oder mehrere Strings für Auswahlmöglichkeiten vom Typ CHECKBOX.

FileUploadAnswers

Alle für eine FileUpload-Frage eingereichten Dateien.

JSON-Darstellung
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Felder
answers[]

object (FileUploadAnswer)

Nur Ausgabe Alle für eine FileUpload-Frage eingereichten Dateien.

FileUploadAnswer

Informationen zu einer einzelnen Datei, die bei einer Dateiupload-Frage eingereicht werden.

JSON-Darstellung
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Felder
fileId

string

Nur Ausgabe Die ID der Google Drive-Datei.

fileName

string

Nur Ausgabe Der Dateiname, wie er beim Hochladen in Google Drive gespeichert wurde.

mimeType

string

Nur Ausgabe Der MIME-Typ der Datei, wie er beim Hochladen in Google Drive gespeichert wurde.

Note

Noten für die Antwort eines Teilnehmers auf eine Frage

JSON-Darstellung
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Felder
score

number

Nur Ausgabe Die Punktzahl, die für die Antwort vergeben wurde.

correct

boolean

Nur Ausgabe Gibt an, ob die Frage richtig beantwortet wurde oder nicht. Eine Nullpunktzahl reicht nicht aus, um eine Unrichtigkeit abzuleiten, da eine richtig beantwortete Frage auch null Punkte wert sein kann.

feedback

object (Feedback)

Nur Ausgabe Zusätzliches Feedback zu einer Antwort.

Methoden

get

Sie erhalten eine Antwort für das Formular.

list

Formularantworten auflisten.