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: 選択されたオプションに対応する 1 つの文字列。
    • 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

ファイルのアップロードに関する質問に対して送信された 1 つのファイルの情報。

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 点の価値が割り当てられてしまう場合があるため、ゼロ点のスコアでは不正解を推測するのに十分ではありません。
feedback

object (Feedback)

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

Methods

get

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

list

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