Class MultipleChoiceItem

MultipleChoiceItem

응답자가 라디오 버튼 목록에서 하나를 선택하거나 선택사항인 '기타' 필드를 확인합니다. 항목은 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)Choice새 선택사항을 만듭니다.
createChoice(value, isCorrect)Choice새 선택사항을 만듭니다.
createChoice(value, navigationItem)Choice지정된 페이지 나누기 항목으로 이동하는 페이지 탐색 옵션이 있는 새 선택을 만듭니다.
createChoice(value, navigationType)Choice페이지 탐색 옵션으로 새 선택을 만듭니다.
createResponse(response)ItemResponse이 다중 선택 항목의 새 ItemResponse를 만듭니다.
duplicate()MultipleChoiceItem이 항목의 사본을 만들어 양식 끝에 추가합니다.
getChoices()Choice[]항목의 모든 선택사항을 가져옵니다.
getFeedbackForCorrect()QuizFeedback응답자가 질문에 올바르게 답변할 때 표시되는 의견을 반환합니다.
getFeedbackForIncorrect()QuizFeedback응답자가 질문에 잘못 응답한 경우 표시되는 의견을 반환합니다.
getHelpText()String항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다.
getId()Integer항목의 고유 식별자를 가져옵니다.
getIndex()Integer양식의 모든 항목에서 항목의 색인을 가져옵니다.
getPoints()Integer채점 가능한 항목의 점수를 반환합니다.
getTitle()String항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).
getType()ItemTypeItemType로 표시된 항목의 유형을 가져옵니다.
hasOtherOption()Boolean항목에 '기타'가 있는지 확인합니다. 옵션을 선택합니다.
isRequired()Boolean응답자가 질문에 반드시 답변해야 하는지 여부를 결정합니다.
setChoiceValues(values)MultipleChoiceItem문자열 배열에서 항목에 대한 선택 항목을 설정합니다.
setChoices(choices)MultipleChoiceItem항목의 선택 배열을 설정합니다.
setFeedbackForCorrect(feedback)MultipleChoiceItem응답자가 질문에 올바르게 답변할 때 응답자에게 의견을 표시하도록 설정합니다.
setFeedbackForIncorrect(feedback)MultipleChoiceItem응답자가 질문에 잘못 답변한 경우 응답자에게 피드백을 표시하도록 설정합니다.
setHelpText(text)MultipleChoiceItem항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
setPoints(points)MultipleChoiceItem채점 가능한 항목의 점수를 설정합니다.
setRequired(enabled)MultipleChoiceItem응답자가 질문에 반드시 답변해야 하는지 여부를 설정합니다.
setTitle(title)MultipleChoiceItem항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).
showOtherOption(enabled)MultipleChoiceItem항목에 '기타'가 있는지 여부를 설정합니다. 옵션을 선택합니다.

자세한 문서

createChoice(value)

새 선택사항을 만듭니다.

매개변수

이름유형설명
valueString응답자가 양식을 볼 때 라벨로 보게 되는 선택 값

리턴

Choice: 새로운 옵션

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createChoice(value, isCorrect)

새 선택사항을 만듭니다.

매개변수

이름유형설명
valueString응답자가 양식을 볼 때 라벨로 보게 되는 선택 값
isCorrectBoolean선택이 정답인지 여부

리턴

Choice: 새로운 옵션

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createChoice(value, navigationItem)

지정된 페이지 나누기 항목으로 이동하는 페이지 탐색 옵션이 있는 새 선택을 만듭니다. 이 navigationType가 FormApp.PageNavigationType.GO_TO_PAGE로 설정된 createChoice(value, navigationType)와 같습니다. 페이지를 사용하는 선택 항목 탐색은 페이지 탐색을 사용하지 않는 옵션과 동일한 항목에서 결합할 수 없습니다.

페이지 탐색은 응답자가 옵션이 포함된 페이지를 완료한 후에 발생합니다. 응답자가 해당 옵션을 선택한 경우에만 응답자가 페이지 탐색 안내를 사용할 수 있지만 마지막 탐색 옵션만 효과가 있습니다. 페이지 탐색은 양식의 마지막 페이지에도 영향을 미치지 않습니다.

매개변수

이름유형설명
valueString응답자가 양식을 볼 때 라벨로 보게 되는 선택 값
navigationItemPageBreakItem이동할 항목

리턴

Choice: 새로운 옵션

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createChoice(value, navigationType)

페이지 탐색 옵션으로 새 선택을 만듭니다. 페이지 탐색을 사용하는 선택 항목은 동일한 항목에서 페이지 탐색을 사용하지 않는 옵션과 결합됩니다.

페이지 탐색은 응답자가 옵션이 포함된 페이지를 완료한 후에 발생합니다. 응답자가 해당 옵션을 선택한 경우에만 응답자가 페이지 탐색 안내를 사용할 수 있지만 마지막 탐색 옵션만 효과가 있습니다. 페이지 탐색은 양식의 마지막 페이지에도 영향을 미치지 않습니다.

매개변수

이름유형설명
valueString응답자가 양식을 볼 때 라벨로 보게 되는 선택 값
navigationTypePageNavigationType선택 항목의 탐색 유형

리턴

Choice: 새로운 옵션

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createResponse(response)

이 다중 선택 항목의 새 ItemResponse를 만듭니다. 다음과 같은 경우 예외가 발생합니다. showOtherOption(enabled)를 true로 설정하지 않으면 response 인수는 이 항목의 유효한 선택과 일치하지 않습니다.

매개변수

이름유형설명
responseString객관식 항목에 대한 유효한 답변입니다.

리턴

ItemResponse: 항목 응답

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

이 항목의 사본을 만들어 양식 끝에 추가합니다.

리턴

MultipleChoiceItem: 체이닝을 위해 이 MultipleChoiceItem의 중복

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getChoices()

항목의 모든 선택사항을 가져옵니다.

리턴

Choice[]: 선택 항목의 배열

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getFeedbackForCorrect()

응답자가 질문에 올바르게 답변할 때 표시되는 의견을 반환합니다.

리턴

QuizFeedback: 의견(있는 경우)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getFeedbackForIncorrect()

응답자가 질문에 잘못 응답한 경우 표시되는 의견을 반환합니다.

리턴

QuizFeedback: 의견(있는 경우)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다.

리턴

String: 항목의 도움말 텍스트 또는 설명 텍스트

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

항목의 고유 식별자를 가져옵니다.

리턴

Integer: 항목의 ID

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

양식의 모든 항목에서 항목의 색인을 가져옵니다.

리턴

Integer: 항목의 색인

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPoints()

채점 가능한 항목의 점수를 반환합니다.

리턴

Integer: 질문의 점수입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

항목의 제목을 가져옵니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

리턴

String: 항목의 제목 또는 헤더 텍스트

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

ItemType로 표시된 항목의 유형을 가져옵니다.

리턴

ItemType: 항목 유형

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

hasOtherOption()

항목에 '기타'가 있는지 확인합니다. 옵션을 선택합니다.

리턴

Boolean — 항목에 '기타'가 포함된 경우 true 옵션; 그렇지 않은 경우 false

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isRequired()

응답자가 질문에 반드시 답변해야 하는지 여부를 결정합니다.

리턴

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']);

매개변수

이름유형설명
valuesString[]응답자가 양식을 볼 때 라벨로 보는 선택 값의 배열

리턴

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')
]);

매개변수

이름유형설명
choicesChoice[]선택 항목의 배열

리턴

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());

매개변수

이름유형설명
feedbackQuizFeedback새 의견을 제공하세요 null 값은 피드백을 지웁니다.

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setFeedbackForIncorrect(feedback)

응답자가 질문에 잘못 답변한 경우 응답자에게 피드백을 표시하도록 설정합니다.

매개변수

이름유형설명
feedbackQuizFeedback새로운 의견

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.

매개변수

이름유형설명
textString새로운 도움말 텍스트

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setPoints(points)

채점 가능한 항목의 점수를 설정합니다. 새 항목의 기본값은 0입니다.

매개변수

이름유형설명
pointsInteger질문 항목이 보유한 포인트 수

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

응답자가 질문에 반드시 답변해야 하는지 여부를 설정합니다.

매개변수

이름유형설명
enabledBoolean응답자가 질문에 답변해야 하는지 여부

리턴

MultipleChoiceItem: 현재 항목 (체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).

매개변수

이름유형설명
titleString새 제목 또는 헤더 텍스트

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

showOtherOption(enabled)

항목에 '기타'가 있는지 여부를 설정합니다. 옵션을 선택합니다. 새 CheckboxItem의 기본값 또는 현재 MultipleChoiceItem이(가) false입니다.

매개변수

이름유형설명
enabledBoolean항목에 '기타'가 포함된 경우 true 옵션; 그렇지 않은 경우 false

리턴

MultipleChoiceItem: 이 MultipleChoiceItem(체이닝용)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms