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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

lastSubmittedTime

string (Timestamp format)

出力専用。レスポンスが最後に送信された時刻のタイムスタンプ。成績の変更は記録されません。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

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 型の選択肢の場合は 1 つの文字列、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

出力専用。アップロード時に Google ドライブに保存されるファイルの MIME タイプ。

成績

質問に対する回答者の回答に関連付けられた成績情報。

JSON 表現
{
  "score": number,
  "correct": boolean,
  "feedback": {
    object (Feedback)
  }
}
フィールド
score

number

出力専用。回答で付与される数値スコア。

correct

boolean

出力専用。質問が正しく回答されたかどうか。正解した質問には 0 点の価値があるため、スコアが 0 点だけでは、不正確さを推測するには不十分です。

feedback

object (Feedback)

出力専用。回答に対する追加のフィードバック。

メソッド

get

フォームから回答を 1 つ取得します。

list

フォームの回答を一覧表示します。