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)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastSubmittedTime

string (Timestamp format)

僅供輸出。上次提交回覆時間的時間戳記。不會追蹤成績變更。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「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 雲端硬碟檔案的 ID。
fileName

string

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

string

僅供輸出。檔案的 MIME 類型，上傳後會儲存在 Google 雲端硬碟中。

成績

與受訪者對問題的答案相關的評分資訊。

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

number

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

boolean

僅供輸出。答案是否正確。零分並不足以推斷答案不正確，因為正確答案的分數也可能為零分。
feedback

object (Feedback)

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

方法

get

 取得表單的一個回應。

list

 列出表單的回應。