양식 내의 질문 항목 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()); } }
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getFeedback() | Object | 응답자가 제출한 답변에 대해 제공된 의견을 확인합니다. |
getItem() | Item | 이 응답에서 답변되는 질문 항목을 가져옵니다. |
getResponse() | Object | 응답자가 제출한 답변을 가져옵니다. |
getScore() | Object | 응답자가 제출한 답변의 점수를 가져옵니다. |
setFeedback(feedback) | ItemResponse | 응답자가 제출한 답변에 표시할 의견을 설정합니다. |
setScore(score) | ItemResponse | 응답자가 제출한 답변의 점수를 설정합니다. |
자세한 문서
getFeedback()
응답자가 제출한 답변에 대해 제공된 의견을 확인합니다.
Return
Object
: 질문 항목의 QuizFeedback
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItem()
getResponse()
응답자가 제출한 답변을 가져옵니다. 대부분의 질문 유형에서는 String
가 반환됩니다.
CheckboxItem
질문의 경우 응답자의 선택사항이 포함된 String[]
배열이 반환됩니다. 배열에서는 문자열의 순서가 다를 수 있습니다.
GridItem
질문의 경우 이는 색인 n
의 답변이 그리드의 n + 1
행에 있는 질문에 해당하는 String[]
배열을 반환합니다. 응답자가 그리드에서 질문에 답변하지 않은 경우 이 응답은 ''
로 반환됩니다.
CheckboxGridItem
질문의 경우 n
색인의 답변이 체크박스 그리드의 n + 1
행에 있는 질문에 해당하는 String[][]
배열을 반환합니다. 응답자가 그리드에서 질문에 답변하지 않은 경우 이 응답은 ''
로 반환됩니다.
Return
Object
: 질문 항목에 대한 답변의 String
또는 String[]
, String[][]
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getScore()
응답자가 제출한 답변의 점수를 가져옵니다.
Return
Object
: 질문 항목의 점수를 나타내는 Double
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedback(feedback)
응답자가 제출한 답변에 표시할 의견을 설정합니다.
이 메서드는 업데이트된 FormResponses로 Form.submitGrades(responses)
를 호출할 때까지 실제로 Forms에 의견을 저장하지 않습니다. 예시는 setScore()
를 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
feedback | Object |
Return
ItemResponse
— 체이닝용 ItemResponse
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setScore(score)
응답자가 제출한 답변의 점수를 설정합니다. null 값을 사용하면 기존 점수가 지워집니다.
이 메서드는 업데이트된 FormResponse로 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 |
Return
ItemResponse
— 체이닝용 ItemResponse
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms