Mục câu hỏi cho phép người trả lời chọn một hoặc nhiều hộp đánh dấu, cũng như
"khác" (không bắt buộc) . Bạn có thể truy cập hoặc tạo các mục từ Form
. Khi được dùng trong
bài kiểm tra, các mục này được chấm điểm tự động.
// 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);
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
clearValidation() | CheckboxItem | Xoá mọi thông tin xác thực dữ liệu cho mục có hộp đánh dấu này. |
createChoice(value) | Choice | Tạo lựa chọn mới. |
createChoice(value, isCorrect) | Choice | Tạo lựa chọn mới. |
createResponse(responses) | ItemResponse | Tạo một ItemResponse mới cho mục có hộp đánh dấu này. |
duplicate() | CheckboxItem | Tạo bản sao của mục này rồi thêm mục này vào cuối biểu mẫu. |
getChoices() | Choice[] | Nhận tất cả các lựa chọn cho một mục. |
getFeedbackForCorrect() | QuizFeedback | Trả về phản hồi hiển thị cho người trả lời khi họ trả lời đúng một câu hỏi. |
getFeedbackForIncorrect() | QuizFeedback | Trả về phản hồi hiển thị cho người trả lời khi họ trả lời sai một câu hỏi. |
getHelpText() | String | Nhận 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 riêng biệ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 được 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ó thuộc tính "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) | CheckboxItem | Đặt các lựa chọn cho một mục từ một mảng chuỗi. |
setChoices(choices) | CheckboxItem | Đặt một mảng các lựa chọn cho một mặt hàng. |
setFeedbackForCorrect(feedback) | CheckboxItem | Đặt phản hồi sẽ hiển thị cho người trả lời khi họ trả lời đúng một câu hỏi. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Đặt phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai một câu hỏi. |
setHelpText(text) | CheckboxItem | Đặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems , PageBreakItems và SectionHeaderItems ). |
setPoints(points) | CheckboxItem | Thiết lập số điểm của một mục có thể chấm điểm. |
setRequired(enabled) | CheckboxItem | Đặt xem người trả lời có phải trả lời câu hỏi hay không. |
setTitle(title) | CheckboxItem | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp là SectionHeaderItem ). |
setValidation(validation) | CheckboxItem | Thiết lập quy tắc xác thực dữ liệu cho mục có hộp đánh dấu này. |
showOtherOption(enabled) | CheckboxItem | Đặt xem mục có giá trị "khác" hay không . |
Tài liệu chi tiết
clearValidation()
Xoá mọi thông tin xác thực dữ liệu cho mục có hộp đánh dấu này.
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
Tạo lựa chọn mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
value | String | giá trị của 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
Choice
— lựa chọn mới
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
value | String | giá trị của 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 |
isCorrect | Boolean | câu trả lời đó có đú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 yêu cầu ủy 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(responses)
Tạo ItemResponse
mới cho mục có hộp đánh dấu này. Đối số responses
là một
Mảng String[]
chứa các giá trị cần kiểm tra. Gửi một ngoại lệ nếu có
không khớp với lựa chọn hợp lệ cho mục này, trừ khi showOtherOption(enabled)
được đặt thành true
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
responses | String[] | một loạt các 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 về mục
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 rồi thêm mục này vào cuối biểu mẫu.
Cầu thủ trả bóng
CheckboxItem
— một bản sao của CheckboxItem
này để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 hiển thị cho người trả lời khi họ trả lời đúng 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 yêu cầu ủy 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 hiển thị cho người trả lời khi họ trả lời sai 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 yêu cầu ủy 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()
Nhận 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ặt hàng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 riêng biệt của mặt hàng.
Cầu thủ trả bóng
Integer
– mã của mặt hàng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 yêu cầu ủy 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 tương xứng với một câu hỏi.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được 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ặt hàng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ó thuộc tính "khác" hay không .
Cầu thủ trả bóng
Boolean
– true
nếu mục có giá trị "khác" ; false
nếu không
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
— 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 yêu cầu ủy 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']);
Tham số
Tên | Loại | 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
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đã cho 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') ]);
Tham số
Tên | Loại | Mô tả |
---|---|---|
choices | Choice[] | một loạt các lựa chọn |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
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 yêu cầu ủy 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 sẽ hiển thị cho người trả lời khi họ trả lời đúng 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());
Tham số
Tên | Loại | 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
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
Đặt phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai một câu hỏi.
Tham số
Tên | Loại | Mô tả |
---|---|---|
feedback | QuizFeedback | phản hồi mới |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được gọi là văn bản mô tả cho các mục bố cục như ImageItems
, PageBreakItems
và SectionHeaderItems
).
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | văn bản trợ giúp mới |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
Thiết lập số điểm của một mục có thể chấm điểm. Giá trị mặc định cho các mục mới là 0.
Tham số
Tên | Loại | Mô tả |
---|---|---|
points | Integer | số điểm của một mục trong câu hỏi |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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)
Đặt xem người trả lời có phải trả lời câu hỏi hay không.
Tham số
Tên | Loại | 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
CheckboxItem
– 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 yêu cầu ủy 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 là SectionHeaderItem
).
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | văn bản tiêu đề hoặc tiêu đề mới |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
setValidation(validation)
Đặt quy tắc xác thực dữ liệu cho mục hộp đánh dấu này. Truyền giá trị rỗng hoặc xác thực mà không có giá trị nào đòi hỏi các hàm được gọi sẽ xoá mọi xác thực trước đó.
Tham số
Tên | Loại | Mô tả |
---|---|---|
validation | CheckboxValidation | Xác thực hộp đánh dấu để áp dụng cho mục này. |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 xem mục có giá trị "khác" hay không . Phương thức mặc định cho CheckboxItem
mới hoặc
MultipleChoiceItem
là false
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
enabled | Boolean | true nếu mục có giá trị "khác" ; false nếu không phải |
Cầu thủ trả bóng
CheckboxItem
— CheckboxItem
này, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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