Mục câu hỏi cho phép người trả lời chọn một lựa chọn trong danh sách các nút chọn hoặc một trường "other" không bắt buộc. Bạn có thể truy cập hoặc tạo các mục trong Form
. Khi được dùng trong một bài kiểm tra, các mục này sẽ được tự động chấm điểm.
// 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);
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
createChoice(value) | Choice | Tạo lựa chọn mới. |
createChoice(value, isCorrect) | Choice | Tạo lựa chọn mới. |
createChoice(value, navigationItem) | Choice | Tạo một lựa chọn mới với tuỳ chọn điều hướng trang sẽ chuyển đến một mục ngắt trang nhất định. |
createChoice(value, navigationType) | Choice | Tạo một lựa chọn mới có tuỳ chọn điều hướng trang. |
createResponse(response) | ItemResponse | Tạo ItemResponse mới cho mục trắc nghiệm này. |
duplicate() | MultipleChoiceItem | Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu. |
getChoices() | Choice[] | Nhận tất cả lựa chọn cho một vật phẩm. |
getFeedbackForCorrect() | QuizFeedback | Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi. |
getFeedbackForIncorrect() | QuizFeedback | Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời sai câu hỏi. |
getHelpText() | String | Lấy văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems , PageBreakItems và SectionHeaderItems ). |
getId() | Integer | Lấy giá trị nhận dạng duy nhất của mặt hàng. |
getIndex() | Integer | Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu. |
getPoints() | Integer | Trả về giá trị điểm của một mục có thể chấm điểm. |
getTitle() | String | Lấy tiêu đề của mục (đôi khi gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem ). |
getType() | ItemType | Lấy loại của mục, được biểu thị dưới dạng ItemType . |
hasOtherOption() | Boolean | Xác định xem mục có tuỳ chọn "khác" hay không. |
isRequired() | Boolean | Xác định xem người trả lời có phải trả lời câu hỏi hay không. |
setChoiceValues(values) | MultipleChoiceItem | Đặt các lựa chọn cho một mục từ một mảng chuỗi. |
setChoices(choices) | MultipleChoiceItem | Đặt một mảng các lựa chọn cho một mặt hàng. |
setFeedbackForCorrect(feedback) | MultipleChoiceItem | Đặt phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi. |
setFeedbackForIncorrect(feedback) | MultipleChoiceItem | Thiết lập phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai câu hỏi. |
setHelpText(text) | MultipleChoiceItem | Đặt văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems , PageBreakItems và SectionHeaderItems ). |
setPoints(points) | MultipleChoiceItem | Đặt số điểm của một vật phẩm có thể chấm điểm. |
setRequired(enabled) | MultipleChoiceItem | Thiết lập liệu người trả lời có phải trả lời câu hỏi hay không. |
setTitle(title) | MultipleChoiceItem | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem ). |
showOtherOption(enabled) | MultipleChoiceItem | Đặt liệu mục có tuỳ chọn "other" hay không. |
Tài liệu chi tiết
createChoice(value)
Tạo lựa chọn mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | String | giá trị của lựa chọn mà người trả lời sẽ nhìn thấy dưới dạng nhãn khi xem biểu mẫu |
Cầu thủ trả bóng
Choice
— lựa chọn mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
Tạo lựa chọn mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | String | giá trị của lựa chọn mà người trả lời sẽ nhìn thấy dưới dạng nhãn khi xem biểu mẫu |
isCorrect | Boolean | liệu lựa chọn này có phải là câu trả lời đúng hay không |
Cầu thủ trả bóng
Choice
— lựa chọn mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, navigationItem)
Tạo một lựa chọn mới với tuỳ chọn điều hướng trang sẽ chuyển đến một mục ngắt trang nhất định. Giá trị này tương đương với createChoice(value, navigationType)
có navigationType
được đặt thành FormApp.PageNavigationType.GO_TO_PAGE
. Bạn không thể kết hợp các lựa chọn sử dụng tính năng điều hướng trang trong cùng một mục với các lựa chọn không sử dụng tính năng điều hướng trang.
Quá trình di chuyển trang diễn ra sau khi người trả lời hoàn tất một trang có chứa lựa chọn và chỉ khi người trả lời chọn lựa chọn đó. Nếu người trả lời chọn nhiều tuỳ chọn có hướng dẫn điều hướng trang trên cùng một trang, thì chỉ tuỳ chọn điều hướng cuối cùng có hiệu lực. Điều hướng trang cũng không ảnh hưởng đến trang cuối cùng của biểu mẫu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | String | giá trị của lựa chọn mà người trả lời sẽ nhìn thấy dưới dạng nhãn khi xem biểu mẫu |
navigationItem | PageBreakItem | mục cần điều hướng đến |
Cầu thủ trả bóng
Choice
— lựa chọn mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
Tạo ItemResponse
mới cho mục trắc nghiệm này. Gửi một ngoại lệ nếu đối số response
không khớp với lựa chọn hợp lệ cho mục này, trừ phi bạn đặt showOtherOption(enabled)
thành true
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
response | String | câu trả lời hợp lệ cho mục trắc nghiệm này |
Cầu thủ trả bóng
ItemResponse
– phản hồi mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu.
Cầu thủ trả bóng
MultipleChoiceItem
– bản sao của MultipleChoiceItem
này để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getChoices()
getFeedbackForCorrect()
Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi.
Cầu thủ trả bóng
QuizFeedback
– ý kiến phản hồi, nếu có.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForIncorrect()
Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời sai câu hỏi.
Cầu thủ trả bóng
QuizFeedback
– ý kiến phản hồi, nếu có.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Lấy văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems
, PageBreakItems
và SectionHeaderItems
).
Cầu thủ trả bóng
String
— văn bản trợ giúp hoặc văn bản mô tả của mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Lấy giá trị nhận dạng duy nhất của mặt hàng.
Cầu thủ trả bóng
Integer
– mã nhận dạng của mặt hàng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
Cầu thủ trả bóng
Integer
– chỉ mục của mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Trả về giá trị điểm của một mục có thể chấm điểm.
Cầu thủ trả bóng
Integer
– số điểm đáng giá của một câu hỏi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Lấy tiêu đề của mục (đôi khi gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem
).
Cầu thủ trả bóng
String
— văn bản tiêu đề hoặc tiêu đề của mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
hasOtherOption()
Xác định xem mục có tuỳ chọn "khác" hay không.
Cầu thủ trả bóng
Boolean
– true
nếu mục có lựa chọn "other"; false
nếu không có lựa chọn này
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Xác định xem người trả lời có phải trả lời câu hỏi hay không.
Cầu thủ trả bóng
Boolean
— liệu người trả lời có phải trả lời câu hỏi hay không
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
Đặt các lựa chọn cho một mục từ một mảng chuỗi. Gửi một ngoại lệ nếu mảng đã cho trống.
// 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']);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
values | String[] | mảng giá trị lựa chọn mà người trả lời sẽ thấy dưới dạng nhãn khi xem biểu mẫu |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoices(choices)
Đặt một mảng các lựa chọn cho một mặt hàng. Gửi một ngoại lệ nếu mảng trống hoặc chứa phần tử 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') ]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
choices | Choice[] | một loạt các lựa chọn |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Gửi
Error
— nếu mảng đã cho là null
, trống hoặc chứa phần tử null
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForCorrect(feedback)
Đặt phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi.
// 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());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
feedback | QuizFeedback | phản hồi mới. Giá trị rỗng sẽ xoá phản hồi. |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
Thiết lập phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai câu hỏi.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
feedback | QuizFeedback | phản hồi mới |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Đặt văn bản trợ giúp của mục (đôi khi gọi là văn bản mô tả cho các mục bố cục như ImageItems
, PageBreakItems
và SectionHeaderItems
).
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | văn bản trợ giúp mới |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Đặt số điểm của một vật phẩm có thể chấm điểm. Giá trị mặc định cho mục mới là 0.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
points | Integer | số điểm đáng giá của một mục trong câu hỏi |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Thiết lập liệu người trả lời có phải trả lời câu hỏi hay không.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
enabled | Boolean | liệu người trả lời có phải trả lời câu hỏi hay không |
Cầu thủ trả bóng
MultipleChoiceItem
– mục hiện tại (để tạo chuỗi)
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem
).
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề hoặc văn bản tiêu đề mới |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
Đặt liệu mục có tuỳ chọn "other" hay không. Tuỳ chọn mặc định cho CheckboxItem
hoặc MultipleChoiceItem
mới là false
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
enabled | Boolean | true nếu mục có tuỳ chọn "other"; false nếu không có tuỳ chọn |
Cầu thủ trả bóng
MultipleChoiceItem
— MultipleChoiceItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms