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 danh sách nút chọn hoặc một trường "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 sử dụng trong bài kiểm tra, các mục này sẽ được chấm tự động.
// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
create | Choice | Tạo một lựa chọn mới. |
create | Choice | Tạo một lựa chọn mới. |
create | Choice | Tạo một lựa chọn mới có tuỳ chọn điều hướng trang chuyển đến một mục ngắt trang nhất định. |
create | Choice | Tạo một lựa chọn mới có tuỳ chọn điều hướng trang. |
create | Item | Tạo một Item mới cho mục có nhiều lựa chọn này. |
duplicate() | Multiple | Tạo một bản sao của mục này và thêm vào cuối biểu mẫu. |
get | Choice[] | Lấy tất cả các lựa chọn cho một mục. |
get | Quiz | 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. |
get | Quiz | Trả về phản hồi hiển thị cho người trả lời khi họ trả lời sai câu hỏi. |
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 | Integer | Trả về giá trị điểm của một mục có thể chấm điểm. |
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 của Section). |
get | Item | Lấy loại của mục, được biểu thị dưới dạng Item. |
has | Boolean | Xác định xem mục có tuỳ chọn "khác" hay không. |
is | Boolean | Xác định xem người trả lời có phải trả lời câu hỏi hay không. |
set | Multiple | Đặt các lựa chọn cho một mục trong một mảng chuỗi. |
set | Multiple | Đặt một mảng các lựa chọn cho một mục. |
set | Multiple | Đặ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. |
set | Multiple | Đặ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. |
set | Multiple | Đặ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 | Multiple | Đặt số điểm cho một mục có thể chấm điểm. |
set | Multiple | Đặt xem người trả lời có phải trả lời câu hỏi hay không. |
set | Multiple | Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section). |
show | Multiple | Đặt xem mục có tuỳ chọn "khác" hay không. |
Tài liệu chi tiết
create
Tạo một 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 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
create
Tạo một 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 thấy dưới dạng nhãn khi xem biểu mẫu |
is | Boolean | liệu lựa chọn đó 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
create
Tạo một lựa chọn mới với tuỳ chọn điều hướng trang chuyển đến một mục ngắt trang nhất định. Điều này tương đương với create với navigation được đặt thành Form. 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.
Thao tác di chuyển trang sẽ diễn ra sau khi người trả lời hoàn tất một trang chứa tuỳ chọn đó và chỉ khi người trả lời chọn tuỳ chọn đó. Nếu người trả lời chọn nhiều lựa chọn có hướng dẫn điều hướng trang trên cùng một trang, thì chỉ lựa chọn điều hướng gần đây nhất mới có hiệu lực. Thao tá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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
value | String | giá trị của lựa chọn mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu |
navigation | Page | mục cần di chuyển đến |
Cầu thủ trả bóng
Choice – lựa chọn mới
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
create
Tạo một Item mới cho mục có nhiều lựa chọn 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 show được đặt thành true.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
response | String | một câu trả lời hợp lệ cho mục trắc nghiệm này |
Cầu thủ trả bóng
Item – phản hồi về mặt hàng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 một bản sao của mục này và thêm vào cuối biểu mẫu.
Cầu thủ trả bóng
Multiple – bản sao của Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
get
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
Quiz – ý 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 yêu cầu đượ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
get
Trả về phản hồi 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
Quiz – ý 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 yêu cầu đượ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
get
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).
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 yêu cầu đượ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
get
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ã của mặt hàng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
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 yêu cầu đượ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
get
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 của một câu hỏi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
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 của Section).
Cầu thủ trả bóng
String – tiêu đề hoặc văn bản tiêu đề của mục
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
get
has
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ó tuỳ chọn "khác"; false nếu không
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
is
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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt các lựa chọn cho một mục trong một mảng chuỗi. Gửi một trường hợp ngoại lệ nếu mảng đã cho trống.
// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 các giá trị lựa chọn mà người trả lời thấy dưới dạng nhãn khi xem biểu mẫu |
Cầu thủ trả bóng
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt một mảng các lựa chọn cho một mục. 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 mảng các lựa chọn |
Cầu thủ trả bóng
Multiple – Multiple 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
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặ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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 | Quiz | ý kiến phản hồi mới. Giá trị rỗng sẽ xoá ý kiến phản hồi. |
Cầu thủ trả bóng
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặ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 | Quiz | ý kiến phản hồi mới |
Cầu thủ trả bóng
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặ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).
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
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt số điểm 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 của một mục câu hỏi |
Cầu thủ trả bóng
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặ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
Multiple – mục hiện tại (để tạo chuỗi)
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
set
Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp của Section).
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
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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
show
Đặt xem mục có tuỳ chọn "khác" hay không. Giá trị mặc định cho Checkbox hoặc Multiple mới là false.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
enabled | Boolean | true nếu mục có tuỳ chọn "khác"; false nếu không |
Cầu thủ trả bóng
Multiple – Multiple này, để tạo chuỗi
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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