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 タイプの選択肢の文字列が 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 点になる可能性があるため、0 点のスコアだけでは不正解を推測できません。
feedback

object (Feedback)

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

メソッド

get

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

list

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