응답자가 라디오 버튼 목록 또는 선택사항 '기타' 필드 중에서 하나를 선택할 수 있는 질문 항목입니다. Form
에서 항목에 액세스하거나 항목을 만들 수 있습니다. 퀴즈에 사용하면 이러한 항목이 자동 채점됩니다.
// Open a form by ID and add a new multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
메서드
자세한 문서
createChoice(value)
createChoice(value, isCorrect)
createChoice(value, navigationItem)
페이지 나누기 옵션으로 지정된 페이지 나누기 항목으로 이동하는 새 선택 항목을 만듭니다. navigationType
가 FormApp.PageNavigationType.GO_TO_PAGE
으로 설정된 createChoice(value, navigationType)
와 같습니다. 페이지 탐색을 사용하는 선택은 페이지 탐색을 사용하지 않는 선택과 동일한 항목에 결합할 수 없습니다.
페이지 탐색은 응답자가 옵션이 포함된 페이지를 완료한 후에, 그리고 응답자가 해당 옵션을 선택한 경우에만 발생합니다. 응답자가 동일한 페이지에 페이지 탐색 안내가 있는 여러 옵션을 선택했다면 마지막 탐색 옵션만 효과가 있습니다. 페이지 탐색은 양식의 마지막 페이지에도 영향을 주지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | String | 응답자가 양식을 볼 때 라벨로 표시하는 선택 값 |
navigationItem | PageBreakItem | 이동할 항목 |
Return
Choice
— 새로운 선택사항
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
이 다중 선택 항목의 새 ItemResponse
를 만듭니다. showOtherOption(enabled)
이 true
로 설정되지 않은 이상 response
인수가 이 항목의 유효한 선택과 일치하지 않으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
response | String | 이 객관식 항목에 대한 유효한 답변 |
Return
ItemResponse
— 항목 응답
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
이 항목의 사본을 만들어 양식 끝에 추가합니다.
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
의 중복으로, 체인용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
getFeedbackForCorrect()
응답자가 질문에 올바르게 응답하면 표시됩니다.
Return
QuizFeedback
: 의견(있는 경우)입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
질문에 잘못 응답한 경우 응답자에게 표시되는 피드백을 반환합니다.
Return
QuizFeedback
: 의견(있는 경우)입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다.
Return
String
: 항목의 도움말 텍스트 또는 설명 텍스트
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
항목의 고유 식별자를 가져옵니다.
Return
Integer
: 항목 ID
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
양식의 모든 항목 중에서 항목의 색인을 가져옵니다.
Return
Integer
: 항목의 색인
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
채점 가능한 항목의 점수를 반환합니다.
Return
Integer
: 질문 하나의 점수를 나타냅니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
항목의 제목을 가져옵니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
Return
String
— 항목의 제목 또는 헤더 텍스트입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
hasOtherOption()
항목에 '기타' 옵션이 있는지 여부를 결정합니다.
Return
Boolean
— 항목에 '기타' 옵션이 있으면 true
이고 그렇지 않으면 false
입니다.
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
응답자가 질문에 답해야 하는지 여부를 결정합니다.
Return
Boolean
: 응답자가 질문에 답해야 하는지 여부
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
문자열 배열에서 항목의 선택을 설정합니다. 지정된 배열이 비어 있으면 예외가 발생합니다.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
매개변수
이름 | 유형 | 설명 |
---|---|---|
values | String[] | 응답자가 양식을 볼 때 라벨로 표시되는 선택 값의 배열 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
항목의 선택사항 배열을 설정합니다. 지정된 배열이 비어 있거나 null
요소가 포함된 경우 예외가 발생합니다.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?') item.setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
매개변수
이름 | 유형 | 설명 |
---|---|---|
choices | Choice[] | 다양한 선택지 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
예외 처리
Error
: 지정된 배열이 null
이거나 비어 있거나 null
요소를 포함하는 경우
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
응답자가 질문에 올바르게 응답하면 표시되는 피드백을 설정합니다.
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); // Set "Dogs" as the correct answer to this question. item.setChoices([ item.createChoice('Dogs', true), item.createChoice('Cats', false)]); // Add feedback which will be shown for correct responses; ie "Dogs". item.setFeedbackForCorrect( FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
매개변수
이름 | 유형 | 설명 |
---|---|---|
feedback | QuizFeedback | 새 의견을 제출합니다. null 값을 사용하면 피드백이 지워집니다. |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
질문에 잘못 응답했을 때 응답자에게 표시할 피드백을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
feedback | QuizFeedback | 새 의견 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 새 도움말 텍스트 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
채점 가능한 항목의 가치를 설정합니다. 새 항목의 기본값은 0입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
points | Integer | 질문 항목의 가치가 있는 포인트 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
응답자가 질문에 답해야 하는지 여부를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
enabled | Boolean | 응답자가 질문에 답변해야 하는지 여부 |
Return
MultipleChoiceItem
: 현재 항목 (체이닝용)
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
항목의 제목을 설정합니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
매개변수
이름 | 유형 | 설명 |
---|---|---|
title | String | 새 제목 또는 헤더 텍스트 |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
항목에 '기타' 옵션이 있는지 여부를 설정합니다. 새 CheckboxItem
또는 MultipleChoiceItem
의 기본값은 false
입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
enabled | Boolean | 항목에 '기타' 옵션이 있으면 true , 그렇지 않으면 false |
Return
MultipleChoiceItem
: 이 MultipleChoiceItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms