Class Choice
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
원하는 대로 선택
CheckboxItem
, ListItem
, MultipleChoiceItem
와 같이 선택을 지원하는 Item
유형과 연결된 단일 선택사항입니다.
// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
item.createChoice('Dogs', FormApp.PageNavigationType.RESTART),
]);
// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');
// Log the navigation types that each choice results in.
const choices = item.getChoices();
for (let i = 0; i < choices.length; i++) {
Logger.log(
'If the respondent chooses "%s", the form will %s.',
choices[i].getValue(),
choices[i].getPageNavigationType(),
);
}
자세한 문서
getGotoPage()
응답자가 이 선택사항을 선택하고 현재 페이지를 완료하면 GO_TO_PAGE
대상으로 설정된 PageBreakItem
를 가져옵니다. 이 메서드는 MultipleChoiceItems
와 연결된 선택사항에만 적용됩니다. 다른 선택사항의 경우 null
을 반환합니다.
리턴
PageBreakItem
: 이 선택의 GO_TO_PAGE
대상 또는 대상이 없는 경우 null
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPageNavigationType()
응답자가 이 선택사항을 선택하고 현재 페이지를 완료하는 경우 발생하는 PageNavigationType
를 가져옵니다. 이 메서드는 MultipleChoiceItems
와 연결된 선택사항에만 적용됩니다. 다른 선택사항의 경우 null
을 반환합니다.
리턴
PageNavigationType
: 이 선택사항의 탐색 작업 또는 작업이 없는 경우 null
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getValue()
응답자가 양식을 볼 때 라벨로 표시되는 선택지 값을 가져옵니다.
리턴
String
: 선택사항의 값
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isCorrectAnswer()
선택사항이 질문에 대한 정답인지 여부를 가져옵니다. 이 메서드는 퀴즈의 일부인 질문에만 적용됩니다. 퀴즈가 아닌 양식의 경우 false를 반환합니다.
리턴
Boolean
: 선택사항이 정답인지 여부입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eA Choice object represents a single selection option within Google Forms items like checkboxes, lists, and multiple-choice questions.\u003c/p\u003e\n"],["\u003cp\u003eChoices can be associated with specific navigation actions, like continuing to the next page or restarting the form, using \u003ccode\u003ePageNavigationType\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve a choice's display value (what the user sees) and determine if it's marked as a correct answer (for quizzes) using dedicated methods.\u003c/p\u003e\n"],["\u003cp\u003eChoice objects are integral for defining response options and controlling form flow based on user selections.\u003c/p\u003e\n"]]],[],null,["# Class Choice\n\nChoice\n\nA single choice associated with a type of [Item](/apps-script/reference/forms/item) that supports choices, like [CheckboxItem](/apps-script/reference/forms/checkbox-item), [ListItem](/apps-script/reference/forms/list-item), or [MultipleChoiceItem](/apps-script/reference/forms/multiple-choice-item).\n\n```javascript\n// Create a new form and add a multiple-choice item.\nconst form = FormApp.create('Form Name');\nconst item = form.addMultipleChoiceItem();\nitem.setTitle('Do you prefer cats or dogs?').setChoices([\n item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),\n item.createChoice('Dogs', FormApp.PageNavigationType.RESTART),\n]);\n\n// Add another page because navigation has no effect on the last page.\nform.addPageBreakItem().setTitle('You chose well!');\n\n// Log the navigation types that each choice results in.\nconst choices = item.getChoices();\nfor (let i = 0; i \u003c choices.length; i++) {\n Logger.log(\n 'If the respondent chooses \"%s\", the form will %s.',\n choices[i].getValue(),\n choices[i].getPageNavigationType(),\n );\n}\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|-------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [getGotoPage()](#getGotoPage()) | [PageBreakItem](/apps-script/reference/forms/page-break-item) | Gets the [PageBreakItem](/apps-script/reference/forms/page-break-item) set as a [GO_TO_PAGE](/apps-script/reference/forms/page-navigation-type) destination if the responder selects this choice and completes the current page. |\n| [getPageNavigationType()](#getPageNavigationType()) | [PageNavigationType](/apps-script/reference/forms/page-navigation-type) | Gets the [PageNavigationType](/apps-script/reference/forms/page-navigation-type) that occurs if the responder selects this choice and completes the current page. |\n| [getValue()](#getValue()) | `String` | Gets the choice's value, which respondents see as a label when viewing the form. |\n| [isCorrectAnswer()](#isCorrectAnswer()) | `Boolean` | Gets whether the choice is a correct answer for the question. |\n\nDetailed documentation\n----------------------\n\n### `get``Goto``Page()`\n\nGets the [PageBreakItem](/apps-script/reference/forms/page-break-item) set as a [GO_TO_PAGE](/apps-script/reference/forms/page-navigation-type) destination\nif the responder selects this choice and completes the current page. This method applies only\nto choices associated with [MultipleChoiceItems](/apps-script/reference/forms/multiple-choice-item); for other choices,\nit returns `null`.\n\n#### Return\n\n\n[PageBreakItem](/apps-script/reference/forms/page-break-item) --- the [GO_TO_PAGE](/apps-script/reference/forms/page-navigation-type) destination for this choice, or `null` if there is none\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Page``Navigation``Type()`\n\nGets the [PageNavigationType](/apps-script/reference/forms/page-navigation-type) that occurs if the responder selects this choice and\ncompletes the current page. This method applies only to choices associated with [MultipleChoiceItems](/apps-script/reference/forms/multiple-choice-item); for other choices, it returns `null`.\n\n#### Return\n\n\n[PageNavigationType](/apps-script/reference/forms/page-navigation-type) --- the navigation action for this choice, or `null` if there is none\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `get``Value()`\n\nGets the choice's value, which respondents see as a label when viewing the form.\n\n#### Return\n\n\n`String` --- the choice's value\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`\n\n*** ** * ** ***\n\n### `is``Correct``Answer()`\n\nGets whether the choice is a correct answer for the question. This method only applies to\nquestions that are part of a quiz; for non-quiz forms, it returns false.\n\n#### Return\n\n\n`Boolean` --- Whether the choice is a correct answer.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/forms.currentonly`\n- `https://www.googleapis.com/auth/forms`"]]