응답자가 드롭다운 목록에서 하나의 옵션을 선택할 수 있는 질문 항목입니다. 항목 할 수 있는 작업
Form
에서 액세스하거나 만들 수 없습니다.
// 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?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]);
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
createChoice(value) | Choice | 새 선택사항을 만듭니다. |
createChoice(value, isCorrect) | Choice | 새 선택사항을 만듭니다. |
createChoice(value, navigationItem) | Choice | 지정된 페이지 나누기 항목으로 이동하는 페이지 탐색 옵션이 있는 새 선택을 만듭니다. |
createChoice(value, navigationType) | Choice | 페이지 탐색 옵션으로 새 선택을 만듭니다. |
createResponse(response) | ItemResponse | 이 목록 항목의 새 ItemResponse 를 만듭니다. |
duplicate() | ListItem | 이 항목의 사본을 만들어 양식 끝에 추가합니다. |
getChoices() | Choice[] | 항목의 모든 선택사항을 가져옵니다. |
getFeedbackForCorrect() | QuizFeedback | 응답자가 질문에 올바르게 답변할 때 표시되는 의견을 반환합니다. |
getFeedbackForIncorrect() | QuizFeedback | 응답자가 질문에 잘못 응답한 경우 표시되는 의견을 반환합니다. |
getHelpText() | String | 항목의 도움말 텍스트 (ImageItems , PageBreakItems , SectionHeaderItems 와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 가져옵니다. |
getId() | Integer | 항목의 고유 식별자를 가져옵니다. |
getIndex() | Integer | 양식의 모든 항목에서 항목의 색인을 가져옵니다. |
getPoints() | Integer | 채점 가능한 항목의 점수를 반환합니다. |
getTitle() | String | 항목의 제목을 가져옵니다 (SectionHeaderItem 의 경우 헤더 텍스트라고도 함). |
getType() | ItemType | ItemType 로 표시된 항목의 유형을 가져옵니다. |
isRequired() | Boolean | 응답자가 질문에 반드시 답변해야 하는지 여부를 결정합니다. |
setChoiceValues(values) | ListItem | 문자열 배열에서 항목에 대한 선택 항목을 설정합니다. |
setChoices(choices) | ListItem | 항목의 선택 배열을 설정합니다. |
setFeedbackForCorrect(feedback) | ListItem | 응답자가 질문에 올바르게 답변할 때 응답자에게 의견을 표시하도록 설정합니다. |
setFeedbackForIncorrect(feedback) | ListItem | 응답자가 질문에 잘못 답변한 경우 응답자에게 피드백을 표시하도록 설정합니다. |
setHelpText(text) | ListItem | 항목의 도움말 텍스트 (ImageItems , PageBreakItems , SectionHeaderItems 와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다. |
setPoints(points) | ListItem | 채점 가능한 항목의 점수를 설정합니다. |
setRequired(enabled) | ListItem | 응답자가 질문에 반드시 답변해야 하는지 여부를 설정합니다. |
setTitle(title) | ListItem | 항목의 제목을 설정합니다 (SectionHeaderItem 의 경우 헤더 텍스트라고도 함). |
자세한 문서
createChoice(value)
createChoice(value, isCorrect)
createChoice(value, navigationItem)
지정된 페이지 나누기 항목으로 이동하는 페이지 탐색 옵션이 있는 새 선택을 만듭니다. 이
navigationType
가 FormApp.PageNavigationType.GO_TO_PAGE
로 설정된 createChoice(value, navigationType)
와 같습니다. 페이지를 사용하는 선택 항목
탐색은 페이지 탐색을 사용하지 않는 옵션과 동일한 항목에서 결합할 수 없습니다.
페이지 탐색은 응답자가 옵션이 포함된 페이지를 완료한 후에 발생합니다. 응답자가 해당 옵션을 선택한 경우에만 응답자가 페이지 탐색 안내를 사용할 수 있지만 마지막 탐색 옵션만 효과가 있습니다. 페이지 탐색은 양식의 마지막 페이지에도 영향을 미치지 않습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | String | 응답자가 양식을 볼 때 라벨로 보게 되는 선택 값 |
navigationItem | PageBreakItem | 이동할 항목 |
리턴
Choice
: 새로운 옵션
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
이 목록 항목의 새 ItemResponse
를 만듭니다. response
인수가 이 항목의 유효한 선택사항과 일치하지 않으면 예외가 발생합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
response | String | 이 목록 항목에 대한 유효한 답변 |
리턴
ItemResponse
: 항목 응답
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
getChoices()
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()
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']);
매개변수
이름 | 유형 | 설명 |
---|---|---|
values | String[] | 응답자가 양식을 볼 때 라벨로 보는 선택 값의 배열 |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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[] | 선택 항목의 배열 |
리턴
생성 값
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 값은 피드백을 지웁니다. |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
응답자가 질문에 잘못 답변한 경우 응답자에게 피드백을 표시하도록 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
feedback | QuizFeedback | 새로운 의견 |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
항목의 도움말 텍스트 (ImageItems
, PageBreakItems
, SectionHeaderItems
와 같은 레이아웃 항목의 설명 텍스트라고도 함)를 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 새로운 도움말 텍스트 |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
setRequired(enabled)
setTitle(title)
항목의 제목을 설정합니다 (SectionHeaderItem
의 경우 헤더 텍스트라고도 함).
매개변수
이름 | 유형 | 설명 |
---|---|---|
title | String | 새 제목 또는 헤더 텍스트 |
리턴
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms