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)

出力のみ。ファイルのアップロードに関する質問への回答。

テキスト回答

テキスト形式の質問の回答。

JSON 表現
{
  "answers": [
    {
      object (TextAnswer)
    }
  ]
}
フィールド
answers[]

object (TextAnswer)

出力のみ。質問への回答。複数値の ChoiceQuestion の場合、各解答は個別の値です。

テキスト回答

テキスト形式の質問に対する回答。

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

ファイルのアップロードが必要な質問に送信された 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

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