REST Resource: forms.responses

리소스: FormResponse

양식 응답

JSON 표현
{
  "formId": string,
  "responseId": string,
  "createTime": string,
  "lastSubmittedTime": string,
  "respondentEmail": string,
  "answers": {
    string: {
      object (Answer)
    },
    ...
  },
  "totalScore": number
}
필드
formId

string

출력 전용입니다. 양식 ID입니다.

responseId

string

출력 전용입니다. 응답 ID입니다.

createTime

string (Timestamp format)

출력 전용입니다. 응답이 처음으로 제출된 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

lastSubmittedTime

string (Timestamp format)

출력 전용입니다. 응답이 제출된 가장 최근 시간의 타임스탬프입니다. 성적 변경사항을 추적하지 않습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

respondentEmail

string

출력 전용입니다. 응답자의 이메일 주소 (수집된 경우)입니다.

answers

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

출력 전용입니다. 질문에 대한 실제 답변으로, questionId를 키로 사용합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

totalScore

number

출력 전용입니다. 응답자가 제출한 답변에 대해 받은 총 점수입니다. 양식이 퀴즈이고 응답에 점수가 부여된 경우에만 설정합니다. 여기에는 양식 소유자가 입력한 수동 수정사항에 따라 자동 채점으로 자동으로 부여된 점수가 포함됩니다.

답변

질문에 제출된 답변입니다.

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.
}
필드
questionId

string

출력 전용입니다. 질문의 ID입니다. Question.question_id을 참고하세요.

grade

object (Grade)

출력 전용입니다. 양식이 퀴즈인 경우 답변의 성적입니다.

통합 필드 value. 사용자의 답변입니다. value은 다음 중 하나여야 합니다.
textAnswers

object (TextAnswers)

출력 전용입니다. 구체적인 답변(텍스트)입니다.

fileUploadAnswers

object (FileUploadAnswers)

출력 전용입니다. 파일 업로드 질문에 대한 답변입니다.

TextAnswers

질문의 답변을 텍스트로 나타냅니다.

JSON 표현
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
필드
answers[]

object (TextAnswer)

출력 전용입니다. 질문에 대한 답변입니다. 값이 여러 개인 ChoiceQuestion의 경우 각 답변은 별도의 값입니다.

TextAnswer

질문에 대한 답변으로 텍스트로 표현됩니다.

JSON 표현
{
  "value": string
}
필드
value

string

출력 전용입니다. 답변 값입니다.

다양한 유형의 질문에 사용되는 형식:

  • ChoiceQuestion
    • RADIO 또는 DROP_DOWN: 선택한 옵션에 해당하는 단일 문자열입니다.
    • CHECKBOX: 선택된 각 옵션에 해당하는 여러 문자열입니다.
  • TextQuestion: 사용자가 입력한 텍스트입니다.
  • ScaleQuestion: 선택한 숫자가 포함된 문자열입니다.
  • DateQuestion
    • 시간 또는 연도 없음: MM-DD(예: '05-19')
    • 연도 포함: YYYY-MM-DD(예: '1986-05-19')
    • 시간 포함: MM-DD HH:MM(예: '05-19 14:51')
    • 연도 및 시간 포함: YYYY-MM-DD HH:MM(예: '1986-05-19 14:51')
  • TimeQuestion: HH:MM 형식의 시간 또는 시간 간격이 포함된 문자열입니다(예: '14:51').
  • QuestionGroupItem 내의 RowQuestion: QuestionGroupItem의 각 행에 대한 답변은 별도의 Answer로 표시됩니다. 각 에는 RADIO 유형 옵션의 경우 하나의 문자열이, CHECKBOX 옵션의 경우 여러 문자열이 포함됩니다.

FileUploadAnswers

FileUpload 질문에 대해 제출된 모든 파일입니다.

JSON 표현
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
필드
answers[]

object (FileUploadAnswer)

출력 전용입니다. FileUpload 질문에 대해 제출된 모든 파일입니다.

FileUploadAnswer

파일 업로드 질문에 제출된 단일 파일의 정보입니다.

JSON 표현
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
필드
fileId

string

출력 전용입니다. Google Drive 파일의 ID입니다.

fileName

string

출력 전용입니다. 업로드 시 Google Drive에 저장된 파일 이름입니다.

mimeType

string

출력 전용입니다. 업로드 시 Google Drive에 저장된 파일의 MIME 유형입니다.

성적

응답자의 질문 답변과 연결된 성적 정보입니다.

JSON 표현
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
필드
score

number

출력 전용입니다. 답변에 부여된 숫자 점수입니다.

correct

boolean

출력 전용입니다. 질문에 올바르게 답변했는지 여부입니다. 정답인 질문에 점수가 0점일 수 있으므로 점수가 0점이라고 해서 틀린 것이라고 추론하기에는 충분하지 않습니다.

feedback

object (Feedback)

출력 전용입니다. 답변에 대한 추가 의견

메서드

get

양식에서 응답 1개를 가져옵니다.

list

양식의 응답을 나열합니다.