응답자가 하나 이상의 체크박스와 '기타' 필드를 선택할 수 있는 질문 항목입니다. Form
에서 항목에 액세스하거나 항목을 만들 수 있습니다. 퀴즈에 사용하면 이러한 항목이 자동 채점됩니다.
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
메서드
자세한 문서
clearValidation()
이 체크박스 항목의 데이터 확인을 삭제합니다.
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
createChoice(value, isCorrect)
createResponse(responses)
이 체크박스 항목의 새 ItemResponse
를 만듭니다. responses
인수는 확인해야 하는 값이 포함된 String[]
배열입니다. showOtherOption(enabled)
가 true
로 설정되지 않은 경우 이 항목의 유효한 선택과 일치하지 않는 값이 있으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
responses | String[] | 이 객관식 항목에 대한 유효한 답변 배열 |
Return
ItemResponse
— 항목 응답
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
이 항목의 사본을 만들어 양식 끝에 추가합니다.
Return
CheckboxItem
: 이 CheckboxItem
의 중복으로, 체인용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
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
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
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
CheckboxItem
: 이 CheckboxItem
, 체이닝용
예외 처리
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
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
질문에 잘못 응답했을 때 응답자에게 표시할 피드백을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
feedback | QuizFeedback | 새 의견 |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 새 도움말 텍스트 |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
채점 가능한 항목의 가치를 설정합니다. 새 항목의 기본값은 0입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
points | Integer | 질문 항목의 가치가 있는 포인트 |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
응답자가 질문에 답해야 하는지 여부를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
enabled | Boolean | 응답자가 질문에 답변해야 하는지 여부 |
Return
CheckboxItem
: 현재 항목 (체이닝용)
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
항목의 제목을 설정합니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
매개변수
이름 | 유형 | 설명 |
---|---|---|
title | String | 새 제목 또는 헤더 텍스트 |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
이 체크박스 항목의 데이터 확인을 설정합니다. 호출된 함수 없이 null 또는 검증을 전달하면 이전의 모든 검증이 삭제됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
validation | CheckboxValidation | 이 항목에 적용할 CheckboxValidation입니다. |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
항목에 '기타' 옵션이 있는지 여부를 설정합니다. 새 CheckboxItem
또는 MultipleChoiceItem
의 기본값은 false
입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
enabled | Boolean | 항목에 '기타' 옵션이 있으면 true , 그렇지 않으면 false |
Return
CheckboxItem
: 이 CheckboxItem
, 체이닝용
승인
이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인해야 합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms