Một mục câu hỏi cho phép người trả lời chọn một lựa chọn trong một chuỗi nút chọn được đánh số. 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, những mục này sẽ được chấm điểm.
// Open a form by ID and add a new scale item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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 |
|---|---|---|
create | Item | Tạo một Item mới cho mục tỷ lệ này. |
duplicate() | Scale | Tạo một bản sao của mục này và thêm bản sao đó vào cuối biểu mẫu. |
get | Quiz | Trả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời một câu hỏi có thể chấm điểm. |
get | String | Lấy 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ư Image, Page và Section). |
get | Integer | Lấy giá trị nhận dạng duy nhất của mặt hàng. |
get | Integer | Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu. |
get | String | Lấy nhãn cho giới hạn dưới của thang đo (nếu có). |
get | Integer | Lấy giới hạn dưới của tỷ lệ. |
get | Integer | Trả về giá trị điểm của một mục có thể chấm điểm. |
get | String | Lấy nhãn cho giới hạn trên của thang điểm (nếu có). |
get | 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 Section). |
get | Item | Lấy loại của mục, được biểu thị dưới dạng Item. |
get | Integer | Lấy giới hạn trên của tỷ lệ. |
is | Boolean | Xác định xem người trả lời có bắt buộc phải trả lời câu hỏi hay không. |
set | Scale | Đặt giới hạn dưới và giới hạn trên của thang đo. |
set | Scale | Đặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời một câu hỏi có thể chấm điểm nhưng không có câu trả lời đúng hoặc sai (tức là những câu hỏi yêu cầu chấm điểm thủ công). |
set | Scale | Đặ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ư Image, Page và Section). |
set | Scale | Đặt nhãn cho giới hạn dưới và giới hạn trên của thang đo. |
set | Scale | Đặt số điểm tương ứng cho một mục có thể chấm điểm. |
set | Scale | Đặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không. |
set | Scale | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp Section). |
Tài liệu chi tiết
createResponse(response)
Tạo một ItemResponse mới cho mục tỷ lệ này. Trả về một trường hợp ngoại lệ nếu đối số response nằm ngoài giới hạn được đặt cho mục.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
response | Integer | một câu trả lời có giá trị cho mục thang điểm này |
Cầu thủ trả bóng
ItemResponse – phản hồi của mục
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
Tạo một bản sao của mục này và thêm bản sao đó vào cuối biểu mẫu.
Cầu thủ trả bóng
ScaleItem – bản sao của ScaleItem này, để liên kết
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Trả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời một câu hỏi có thể chấm điểm.
Cầu thủ trả bóng
QuizFeedback|null – ý kiến phản hồi (nếu có).
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 được 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
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 thang đo (nếu có).
Cầu thủ trả bóng
String – nhãn cho giới hạn dưới của thang đo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getLowerBound()
Lấy giới hạn dưới của tỷ lệ.
Cầu thủ trả bóng
Integer – giới hạn dưới của thang đo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 ứng với một câu hỏi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 thang điểm (nếu có).
Cầu thủ trả bóng
String – nhãn cho giới hạn trên của thang đo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 SectionHeaderItem).
Cầu thủ trả bóng
String – tiêu đề hoặc văn bản tiêu đề của mặt hàng
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 thang đo
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Xác định xem người trả lời có bắt buộ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ó bắt buộc phải trả lời câu hỏi hay không
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 thang đo. 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. Theo mặc định, một thang đo mới sẽ có giới hạn dưới là 1 và giới hạn trên là 5.
Gửi một ngoại lệ về 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 sẽ bị cắt bớt thành số nguyên đứng trước.
Tham số
| Tên | Loại | 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, để xâu chuỗi
Gửi
Error – nếu cận dưới hoặc cận trên không hợp lệ
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Đặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời một câu hỏi có thể chấm điểm nhưng không có câu trả lời đúng hoặc sai (tức là những câu hỏi yêu cầu chấm điểm thủ công).
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
feedback | Quiz | ý kiến phản hồi mới |
Cầu thủ trả bóng
ScaleItem – ScaleItem này, để xâu chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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
ScaleItem – ScaleItem này, để xâu chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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 thang đo.
Tham số
| Tên | Loại | 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, để xâu chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Đặt số điểm tương ứng cho 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 tương ứng với một câu hỏi |
Cầu thủ trả bóng
ScaleItem – ScaleItem này, để xâu chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
Đặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
enabled | Boolean | người trả lời có bắt buộ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 (để liên kết)
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
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).
Tham số
| Tên | Loại | 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, để xâu chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms