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 Einreichen der Antwort.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
lastSubmittedTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die letzte Antwort. Änderungen an Noten werden nicht erfasst.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
respondentEmail

string

Nur Ausgabe. Die E-Mail-Adresse des Teilnehmers (falls erfasst).
answers

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

Nur Ausgabe. Die tatsächlichen Antworten auf die Fragen, sortiert 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 Gesamtpunktzahl, die der Teilnehmer für seine Antwort erhalten hat. Nur festlegen, wenn das Formular ein Quiz war und die Antwort benotet wurde. Dazu gehören auch Punkte, die automatisch über die automatische Benotung vergeben wurden und durch manuelle Korrekturen des Eigentümers des Formulars angepasst 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 Hochladen von Dateien.

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

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 den einzelnen ausgewählten Optionen 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: TT-MM 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 Uhrzeit 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. Jedes enthält einen String für RADIO-Auswahlmöglichkeiten oder mehrere Strings für CHECKBOX-Auswahlmöglichkeiten.

FileUploadAnswers

Alle eingereichten Dateien für eine Frage zum Hochladen von Dateien.

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

object (FileUploadAnswer)

Nur Ausgabe. Alle eingereichten Dateien für eine Frage zum Hochladen von Dateien.

FileUploadAnswer

Informationen zu einer einzelnen Datei, die für eine Frage zum Hochladen von Dateien 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 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

Benotungsinformationen, die mit der Antwort eines Teilnehmers auf eine Frage verknüpft sind.

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

number

Nur Ausgabe. Die Bewertung der Antwort.
correct

boolean

Nur Ausgabe. Ob die Frage richtig beantwortet wurde oder nicht. Eine Punktzahl von null Punkten reicht nicht aus, um auf eine Falschheit zu schließen, da eine richtig beantwortete Frage auch null Punkte wert sein kann.
feedback

object (Feedback)

Nur Ausgabe. Zusätzliches Feedback zu einer Antwort.

Methoden

get

 Eine Antwort aus dem Formular abrufen

list

 Antworten auf ein Formular auflisten