Class CheckboxItem

CheckboxItem

응답자가 하나 이상의 체크박스를 선택할 수 있는 질문 항목과 선택사항인 'other' 필드입니다. 항목은 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()CheckboxItem이 체크박스 항목에 대한 데이터 확인을 삭제합니다.
createChoice(value)Choice새 선택지를 만듭니다.
createChoice(value, isCorrect)Choice새 선택지를 만듭니다.
createResponse(responses)ItemResponse이 체크박스 항목의 새 ItemResponse를 만듭니다.
duplicate()CheckboxItem이 항목의 사본을 만들어 양식 끝에 추가합니다.
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)CheckboxItem문자열 배열에서 항목에 대한 선택 항목을 설정합니다.
setChoices(choices)CheckboxItem항목의 선택 배열을 설정합니다.
setFeedbackForCorrect(feedback)CheckboxItem응답자가 질문에 올바르게 응답하면 응답자에게 피드백이 표시되도록 설정합니다.
setFeedbackForIncorrect(feedback)CheckboxItem응답자가 질문에 잘못 응답했을 때 응답자에게 피드백이 표시되도록 설정합니다.
setHelpText(text)CheckboxItem항목의 도움말 텍스트 (ImageItems, PageBreakItems, SectionHeaderItems와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
setPoints(points)CheckboxItem채점 가능한 항목의 점수를 설정합니다.
setRequired(enabled)CheckboxItem응답자가 질문에 반드시 답변해야 하는지 여부를 설정합니다.
setTitle(title)CheckboxItem항목의 제목을 설정합니다 (SectionHeaderItem의 경우 헤더 텍스트라고도 함).
setValidation(validation)CheckboxItem이 체크박스 항목의 데이터 유효성 검사를 설정합니다.
showOtherOption(enabled)CheckboxItem항목에 '기타' 옵션이 있는지 여부를 설정합니다.

자세한 문서

clearValidation()

이 체크박스 항목에 대한 데이터 확인을 삭제합니다.

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

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

createResponse(responses)

이 체크박스 항목의 새 ItemResponse를 만듭니다. responses 인수는 확인해야 할 값이 포함된 String[] 배열입니다. showOtherOption(enabled)이 true로 설정되지 않은 경우, 이 항목의 유효한 선택과 일치하는 값이 하나도 없으면 예외가 발생합니다.

매개변수

이름유형설명
responsesString[]이 객관식 항목에 대한 유효한 답변의 배열

리턴

ItemResponse: 항목 응답

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

duplicate()

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

리턴

CheckboxItem: 연결을 위해 이 CheckboxItem의 복제본입니다.

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

  • 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[]응답자가 양식을 볼 때 라벨로 보게 되는 선택 값의 배열

리턴

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

매개변수

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

리턴

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

매개변수

이름유형설명
feedbackQuizFeedback확인할 수 있습니다. null 값은 의견이 삭제됩니다.

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setFeedbackForIncorrect(feedback)

응답자가 질문에 잘못 응답했을 때 응답자에게 피드백이 표시되도록 설정합니다.

매개변수

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

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setHelpText(text)

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

매개변수

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

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setPoints(points)

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

매개변수

이름유형설명
pointsInteger질문 항목의 점수

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setRequired(enabled)

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

매개변수

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

리턴

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

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setTitle(title)

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

매개변수

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

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

setValidation(validation)

이 체크박스 항목의 데이터 유효성 검사를 설정합니다. 필수 함수 없이 null 또는 유효성 검사를 전달하면 이전 유효성 검사가 삭제됩니다.

매개변수

이름유형설명
validationCheckboxValidation이 항목에 적용할 CheckboxValidation입니다.

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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

showOtherOption(enabled)

항목에 '기타' 옵션이 있는지 여부를 설정합니다. 새 CheckboxItem 또는 MultipleChoiceItem의 기본값은 false입니다.

매개변수

이름유형설명
enabledBoolean항목에 '기타' 옵션이 있으면 true, 없으면 false입니다.

리턴

CheckboxItem: 이 CheckboxItem, 체이닝용

승인

이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.

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