Trang này được dịch bởi Cloud Translation API.

Class ListItem

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 thả xuống. Bạn có thể truy cập hoặc tạo các mục từ Form.

// 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?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`createChoice(value)`	`Choice`	Tạo một lựa chọn mới.
`createChoice(value, isCorrect)`	`Choice`	Tạo một 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 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 một `ItemResponse` mới cho mục danh sách này.
`duplicate()`	`ListItem`	Tạo một bản sao của mục này và thêm vào cuối biểu mẫu.
`getChoices()`	`Choice[]`	Lấy 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 câu hỏi.
`getHelpText()`	`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ư `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 được gọi là văn bản tiêu đề, trong trường hợp của `SectionHeaderItem`).
`getType()`	`ItemType`	Lấy loại của mục, được biểu thị dưới dạng `ItemType`.
`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)`	`ListItem`	Đặt các lựa chọn cho một mục trong một mảng chuỗi.
`setChoices(choices)`	`ListItem`	Đặt một mảng các lựa chọn cho một mục.
`setFeedbackForCorrect(feedback)`	`ListItem`	Đặ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)`	`ListItem`	Đặ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)`	`ListItem`	Đặ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)`	`ListItem`	Đặt số điểm của một mục có thể chấm điểm.
`setRequired(enabled)`	`ListItem`	Đặt xem người trả lời có phải trả lời câu hỏi hay không.
`setTitle(title)`	`ListItem`	Đặ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 `SectionHeaderItem`).

Tài liệu chi tiết

`createChoice(value)`

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

`createChoice(value, isCorrect)`

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
`isCorrect`	`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

`createChoice(value, navigationItem)`

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 createChoice(value, navigationType) với 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.

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
`navigationItem`	`PageBreakItem`	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

`createChoice(value, navigationType)`

Tạo một lựa chọn mới có tuỳ chọn điều hướng trang. 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.

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
`navigationType`	`PageNavigationType`	loại điều hướng của lựa chọ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

`createResponse(response)`

Tạo một ItemResponse mới cho mục danh sách 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.

Tham số

Tên	Loại	Mô tả
`response`	`String`	câu trả lời hợp lệ cho mục danh sách này

Cầu thủ trả bóng

ItemResponse – 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

ListItem – bản sao của ListItem 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

`getChoices()`

Lấy tất cả các lựa chọn cho một mục.

Cầu thủ trả bóng

Choice[] – một mảng các lựa chọn

Ủ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

`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

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

`getFeedbackForIncorrect()`

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

QuizFeedback – ý 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

`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 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

`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ã 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

`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 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

`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 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

`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 của SectionHeaderItem).

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

`getType()`

Lấy loại của mục, được biểu thị dưới dạng ItemType.

Cầu thủ trả bóng

ItemType – loại 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

`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

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

`setChoiceValues(values)`

Đặ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

ListItem – ListItem 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

`setChoices(choices)`

Đặ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

ListItem – ListItem 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

`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.
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`	`QuizFeedback`	ý 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

ListItem – ListItem 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

`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`	ý kiến phản hồi mới

Cầu thủ trả bóng

ListItem – ListItem 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

`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

ListItem – ListItem 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

`setPoints(points)`

Đặt 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 câu hỏi

Cầu thủ trả bóng

ListItem – ListItem 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

`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

ListItem – 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

`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 của 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

ListItem – ListItem 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