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)

僅供輸出。首次提交回應的時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastSubmittedTime

string (Timestamp format)

僅供輸出。最近一次提交回應的時間戳記。但不會追蹤成績變動。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
respondentEmail

string

僅供輸出。如果系統收集了作答者的電子郵件地址，
answers

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

僅供輸出。問題的實際答案，以問號 ID 做為鍵。

這個物件中包含 "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

所有針對「檔案上傳」問題提交的檔案。

JSON 表示法 
{
  "answers": [
    {
      object (FileUploadAnswer)
    }
  ]
}
欄位
answers[]

object (FileUploadAnswer)

僅供輸出。所有針對「檔案上傳」問題提交的檔案。

FileUploadAnswer

提交至檔案上傳問題的單一檔案資訊。

JSON 表示法 
{
  "fileId": string,
  "fileName": string,
  "mimeType": string
}
欄位
fileId

string

僅供輸出。Google 雲端硬碟檔案的 ID。
fileName

string

僅供輸出。上傳時儲存在 Google 雲端硬碟中的檔案名稱。
mimeType

string

僅供輸出。檔案的 MIME 類型；上傳時儲存在 Google 雲端硬碟的檔案。

成績

與作答者答案相關聯的成績資訊。

JSON 表示法 
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
欄位
score

number

僅供輸出。答案獲得的分數。
correct

boolean

僅供輸出。問題是否正確回答。僅含 0 分的分數不足以推論錯誤，因為答對的問題應該已經等於零分。
feedback

object (Feedback)

僅供輸出。對答案提供的其他意見回饋。

方法

get

 透過表單取得一個回應。

list

 列出表單的回覆。