REST Resource: forms.responses

Zasób: FormResponse

odpowiedź na formularz.

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

string

Tylko dane wyjściowe. Identyfikator formularza.

responseId

string

Tylko dane wyjściowe. Identyfikator odpowiedzi.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa przesłania pierwszej odpowiedzi.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

lastSubmittedTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniego przesłania odpowiedzi. Nie śledzi zmian w ocenach.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

respondentEmail

string

Tylko dane wyjściowe. Adres e-mail użytkownika (jeśli został zebrany).

answers

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

Tylko dane wyjściowe. Rzeczywiste odpowiedzi na pytania, posortowane według questionId.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

totalScore

number

Tylko dane wyjściowe. Łączna liczba punktów uzyskanych przez respondenta za przesłane dane. Ustaw tylko wtedy, gdy formularz był testem, a odpowiedź została oceniona. Obejmuje to punkty przyznawane automatycznie przez system, skorygowane o ręczne poprawki wprowadzone przez właściciela formularza.

Odpowiedź

Przesłana odpowiedź na pytanie.

Zapis JSON
{
  "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.
}
Pola
questionId

string

Tylko dane wyjściowe. Identyfikator pytania. Zobacz też Question.question_id.

grade

object (Grade)

Tylko dane wyjściowe. Ocena za odpowiedź, jeśli formularz był testem.

Pole unii value. Odpowiedź użytkownika. value może być tylko jednym z tych elementów:
textAnswers

object (TextAnswers)

Tylko dane wyjściowe. konkretne odpowiedzi w formie tekstu.

fileUploadAnswers

object (FileUploadAnswers)

Tylko dane wyjściowe. odpowiedzi na pytanie dotyczące przesyłania plików,

TextAnswers

tekstowe odpowiedzi na pytania;

Zapis JSON
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
Pola
answers[]

object (TextAnswer)

Tylko dane wyjściowe. odpowiedzi na pytanie, W przypadku pytań z wieloma wartościami ChoiceQuestion każda odpowiedź jest osobną wartością.

TextAnswer

Odpowiedź na pytanie w postaci tekstu.

Zapis JSON
{
  "value": string
}
Pola
value

string

Tylko dane wyjściowe. Wartość odpowiedzi.

Formatowanie stosowane w przypadku różnych rodzajów pytań:

  • ChoiceQuestion
    • RADIO lub DROP_DOWN: pojedynczy ciąg znaków odpowiadający wybranej opcji.
    • CHECKBOX: wiele ciągów znaków odpowiadających każdej wybranej opcji.
  • TextQuestion: tekst wpisany przez użytkownika.
  • ScaleQuestion: ciąg znaków zawierający wybrany numer.
  • DateQuestion
    • Bez godziny i roku: DD-MM, np. „05-19”.
    • Z rokiem: RRRR-MM-DD, np. „1986-05-19”.
    • Z czasem: MM-DD HH:MM, np. „05-19 14:51”.
    • Z rokiem i godzinami: RRRR-MM-DD GG:MM, np. „1986-05-19 14:51”.
  • TimeQuestion: ciąg tekstowy z czasem lub czasem trwania w formacie GG:MM, np. „14:51”.
  • RowQuestionQuestionGroupItem: odpowiedź dla każdego wiersza w tabeli QuestionGroupItem jest reprezentowana jako osobna kolumna Answer. Każdy z nich będzie zawierać 1 ciąg znaków w przypadku opcji typu RADIO lub wiele ciągów znaków w przypadku opcji typu CHECKBOX.

FileUploadAnswers

Wszystkie przesłane pliki w przypadku pytania typu FileUpload.

Zapis JSON
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
Pola
answers[]

object (FileUploadAnswer)

Tylko dane wyjściowe. Wszystkie przesłane pliki w przypadku pytania typu FileUpload.

FileUploadAnswer

Informacje o pojedynczym pliku przesłanym w odpowiedzi na pytanie dotyczące przesyłania plików.

Zapis JSON
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
Pola
fileId

string

Tylko dane wyjściowe. Identyfikator pliku z Dysku Google.

fileName

string

Tylko dane wyjściowe. nazwa pliku, jak została zapisana na Dysku Google podczas przesyłania;

mimeType

string

Tylko dane wyjściowe. Typ MIME pliku, który został zapisany na Dysku Google podczas przesyłania.

Ocena

Informacje o ocenie powiązanej z odpowiedzią respondenta na pytanie.

Zapis JSON
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
Pola
score

number

Tylko dane wyjściowe. Wynik liczbowy przyznany odpowiedzi.

correct

boolean

Tylko dane wyjściowe. czy odpowiedź na pytanie jest poprawna. Wynik 0 punktów nie wystarczy do stwierdzenia, że odpowiedź jest nieprawidłowa, ponieważ prawidłowo rozwiązane pytanie może nie przynieść żadnych punktów.

feedback

object (Feedback)

Tylko dane wyjściowe. Dodatkowa opinia na temat odpowiedzi.

Metody

get

Uzyskaj jedną odpowiedź z formularza.

list

Wyświetlić odpowiedzi w formularzu.