フォーム内の 1 つの質問項目に対する回答。FormResponse からアイテムの回答にアクセスでき、回答者に質問への回答を求める任意の Item から作成できます。
// Open a form by ID and log the responses to each question.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var formResponses = form.getResponses();
for (var i = 0; i < formResponses.length; i++) {
var formResponse = formResponses[i];
var itemResponses = formResponse.getItemResponses();
for (var j = 0; j < itemResponses.length; j++) {
var itemResponse = itemResponses[j];
Logger.log('Response #%s to the question "%s" was "%s"',
(i + 1).toString(),
itemResponse.getItem().getTitle(),
itemResponse.getResponse());
}
}
Methods
| 方法 | 戻り値の型 | 概要 |
|---|---|---|
getFeedback() | Object | 回答者が送信した回答に対して得られたフィードバックを取得します。 |
getItem() | Item | この回答が回答する質問アイテムを取得します。 |
getResponse() | Object | 回答者が送信した回答を取得します。 |
getScore() | Object | 回答者が送信した回答のスコアを取得します。 |
setFeedback(feedback) | ItemResponse | 回答者が送信した回答に対して表示するフィードバックを設定します。 |
setScore(score) | ItemResponse | 回答者が送信した回答のスコアを設定します。 |
詳細なドキュメント
getFeedback()
回答者が送信した回答に対して得られたフィードバックを取得します。
戻る
Object - 質問アイテムの QuizFeedback。
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getItem()
getResponse()
回答者が送信した回答を取得します。ほとんどの質問項目では、String を返します。
CheckboxItem に関する質問については、回答者の選択肢を含む String[] 配列が返されます。配列内の文字列の順序は異なる場合があります。
GridItem 質問の場合、インデックス n の回答がグリッドの行 n + 1 の質問に対応する String[] 配列を返します。回答者がグリッド内の質問に回答しなかった場合、その回答は '' として返されます。
CheckboxGridItem 質問の場合は、String[][] 配列が返されます。この配列では、行インデックス n の回答は、チェックボックス グリッドの行 n + 1 の質問に対応しています。回答者がグリッド内の質問に回答しなかった場合、その回答は '' として返されます。
戻る
Object - 質問項目に対する回答の String、String[]、または String[][]
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getScore()
回答者が送信した回答のスコアを取得します。
戻る
Object - 質問アイテムのスコアを表す Double
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setFeedback(feedback)
回答者が送信した回答に対して表示されるフィードバックを設定します。
このメソッドは、更新された FormResponses で Form.submitGrades(responses) が呼び出されるまで、実際にフィードバックをフォームに保存しません。setScore() の例をご覧ください。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
feedback | Object |
戻る
ItemResponse - チェーン用の ItemResponse
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setScore(score)
回答者が送信した回答のスコアを設定します。null 値を指定すると、既存のスコアがクリアされます。
このメソッドは、更新された FormResponses で Form.submitGrades(responses) が呼び出されるまで、実際にフォームにスコアを保存しません。
// For a multiple choice question with options: "Always true", "Sometimes true", and "Never",
// award half credit for responses that answered "Sometimes true".
var formResponses = FormApp.getActiveForm().getResponses();
// Go through each form response
for (var i = 0; i < formResponses.length; i++) {
var response = formResponses[i];
var items = FormApp.getActiveForm().getItems();
// Assume it's the first item
var item = items[0];
var itemResponse = response.getGradableResponseForItem(item);
// Give half credit for "Sometimes true".
if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') {
var points = item.asMultipleChoiceItem().getPoints();
itemResponse.setScore(points * .5);
// This saves the grade, but does not submit to Forms yet.
response.withItemGrade(itemResponse);
}
}
// Grades are actually submitted to Forms here.
FormApp.getActiveForm().submitGrades(formResponses);
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
score | Object |
戻る
ItemResponse - チェーン用の ItemResponse
認可
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms