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. Zeitstempel für das erste Senden der Antwort.

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

string (Timestamp format)

Nur Ausgabe. Zeitstempel für den Zeitpunkt, zu dem die Antwort zuletzt gesendet wurde. Es werden keine Änderungen an Noten nachverfolgt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 (falls erfasst) des Befragten.
answers

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

Nur Ausgabe. Die tatsächlichen Antworten auf die Fragen, eingeschlüsselt 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. Wird nur festgelegt, wenn es sich bei dem Formular um ein Quiz handelt und die Antwort benotet wurde. Dazu gehören auch Punkte, die automatisch durch automatische Benotung vergeben werden und durch manuelle Korrekturen korrigiert werden, die vom Eigentümer des Formulars eingegeben wurden.

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 für die Antwort, wenn es sich bei dem Formular um ein Quiz handelt.
Union-Feld value. Die Antwort des Nutzers. Für value ist nur einer der folgenden Werte zulässig:
textAnswers

object (TextAnswers)

Nur Ausgabe. Die spezifischen Antworten als Text.
fileUploadAnswers

object (FileUploadAnswers)

Nur Ausgabe. Die Antworten auf eine Frage zum Dateiupload.

TextAnswers

Die Antworten einer Frage als Text.

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

object (TextAnswer)

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

TextAnswer

Eine Antwort auf eine als Text dargestellte Frage.

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

string

Nur Ausgabe. Der Antwortwert.

Formatierung 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 mit der ausgewählten Zahl.
  • DateQuestion
    • Ohne Uhrzeit oder Jahr: MM-TT z.B. „05–19“
    • Mit Jahr: JJJJ-MM-TT z.B. „19.05.1986“
    • Mit Zeit: 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 HH:MM-Format, z.B. „14:51“
  • RowQuestion innerhalb von QuestionGroupItem: Die Antwort für jede Zeile einer QuestionGroupItem wird als separates Answer dargestellt. Jede 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 im Rahmen einer Dateiupload-Frage eingereicht wurde.

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 Upload in Google Drive gespeichert wird.
mimeType

string

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

Note

Informationen im Zusammenhang mit der Antwort eines Teilnehmers auf eine Frage benoten.

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

number

Nur Ausgabe. Der für die Antwort vergebene numerische Wert.
correct

boolean

Nur Ausgabe. Ob die Frage richtig beantwortet wurde oder nicht Eine Nullpunktzahl reicht nicht aus, um Fehler abzuleiten, da eine richtig beantwortete Frage 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

 Hiermit listen Sie die Antworten eines Formulars auf.