Mục câu hỏi cho phép người trả lời chọn một đáp án trong một chuỗi các nút chọn được đánh số. Bạn có thể truy cập hoặc tạo các mục trong Form
. Khi dùng trong bài kiểm tra, các mục này sẽ được chấm điểm.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
createResponse(response) | ItemResponse | Tạo một ItemResponse mới cho mục tỷ lệ này. |
duplicate() | ScaleItem | Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu. |
getGeneralFeedback() | QuizFeedback | Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời câu hỏi có thể chấm điểm. |
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. |
getLeftLabel() | String | Lấy nhãn cho giới hạn dưới của tỷ lệ, nếu có. |
getLowerBound() | Integer | Lấy giới hạn dưới của thang đo. |
getPoints() | Integer | Trả về giá trị điểm của một mục có thể chấm điểm. |
getRightLabel() | String | Lấy nhãn cho giới hạn trên của tỷ lệ, nếu có. |
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 . |
getUpperBound() | Integer | Lấy giới hạn trên của tỷ lệ. |
isRequired() | Boolean | Xác định xem người trả lời có phải trả lời câu hỏi hay không. |
setBounds(lower, upper) | ScaleItem | Đặt giới hạn dưới và giới hạn trên của tỷ lệ. |
setGeneralFeedback(feedback) | ScaleItem | Thiết lập để người trả lời xem được nội dung phản hồi khi họ trả lời câu hỏi có thể chấm điểm nhưng không có câu trả lời chính xác hoặc không chính xác (chẳng hạn như những câu hỏi yêu cầu chấm điểm theo cách thủ công). |
setHelpText(text) | ScaleItem | Đặ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 ). |
setLabels(lower, upper) | ScaleItem | Đặt nhãn cho giới hạn dưới và giới hạn trên của tỷ lệ. |
setPoints(points) | ScaleItem | Đặt số điểm của một vật phẩm có thể chấm điểm. |
setRequired(enabled) | ScaleItem | 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) | ScaleItem | Đặ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 ). |
Tài liệu chi tiết
createResponse(response)
Tạo một ItemResponse
mới cho mục tỷ lệ này. Gửi một ngoại lệ nếu đối số response
nằm ngoài giới hạn được đặt cho mục.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
response | Integer | một câu trả lời giá trị cho mục tỷ lệ 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
ScaleItem
– bản sao của ScaleItem
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
getGeneralFeedback()
Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời câu hỏi có thể chấm điểm.
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
getLeftLabel()
Lấy nhãn cho giới hạn dưới của tỷ lệ, nếu có.
Cầu thủ trả bóng
String
– nhãn cho giới hạn dưới của tỷ lệ
Ủ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
getLowerBound()
Lấy giới hạn dưới của thang đo.
Cầu thủ trả bóng
Integer
— giới hạn dưới của thang đo
Ủ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
getRightLabel()
Lấy nhãn cho giới hạn trên của tỷ lệ, nếu có.
Cầu thủ trả bóng
String
– nhãn cho giới hạn trên của tỷ lệ
Ủ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()
getUpperBound()
Lấy giới hạn trên của tỷ lệ.
Cầu thủ trả bóng
Integer
– giới hạn trên của tỷ lệ
Ủ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
setBounds(lower, upper)
Đặt giới hạn dưới và giới hạn trên của tỷ lệ. Giới hạn dưới phải là 0
hoặc 1
. Giới hạn trên phải nằm trong khoảng từ 3
đến 10
. Tỷ lệ mới mặc định là giới hạn dưới là 1
và giới hạn trên là 5
.
Gửi ngoại lệ cho tập lệnh nếu các giá trị đã cho nằm ngoài giới hạn cho phép. Số thập phân được cắt bớt đến số nguyên trước đó.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
lower | Integer | giới hạn dưới mới |
upper | Integer | giới hạn trên mới |
Cầu thủ trả bóng
ScaleItem
— ScaleItem
này, để tạo chuỗi
Gửi
Error
– nếu giới hạn dưới hoặc giới hạn trên không hợp lệ
Ủ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
setGeneralFeedback(feedback)
Thiết lập để người trả lời xem được nội dung phản hồi khi họ trả lời câu hỏi có thể chấm điểm nhưng không có câu trả lời chính xác hoặc không chính xác (chẳng hạn như những câu hỏi yêu cầu chấm điểm theo cách thủ công).
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
ScaleItem
— ScaleItem
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
ScaleItem
— ScaleItem
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
setLabels(lower, upper)
Đặt nhãn cho giới hạn dưới và giới hạn trên của tỷ lệ.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
lower | String | nhãn mới cho giới hạn dưới |
upper | String | nhãn mới cho giới hạn trên |
Cầu thủ trả bóng
ScaleItem
— ScaleItem
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
ScaleItem
— ScaleItem
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
ScaleItem
– 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
ScaleItem
— ScaleItem
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