フォーム内の 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