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

Class CheckboxItem

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ư một trường "other" không bắt buộc. Bạn có thể truy cập hoặc tạo các mục trong Form. Khi được dùng trong một bài kiểm tra, các mục này sẽ được tự động chấm điểm.

// 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	Kiểu 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 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 `ItemResponse` mới cho mục hộp đánh dấu này.
`duplicate()`	`CheckboxItem`	Tạo bản sao của mục này và thêm mục vào cuối biểu mẫu.
`getChoices()`	`Choice[]`	Nhận tất cả lựa chọn cho một vật phẩm.
`getFeedbackForCorrect()`	`QuizFeedback`	Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi.
`getFeedbackForIncorrect()`	`QuizFeedback`	Trả về phản hồi được 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 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 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ó tuỳ chọn "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 được hiển thị cho người trả lời khi họ trả lời đúng cho một câu hỏi.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Thiết lập phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai câu hỏi.
`setHelpText(text)`	`CheckboxItem`	Đặ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`).
`setPoints(points)`	`CheckboxItem`	Đặt số điểm của một vật phẩm có thể chấm điểm.
`setRequired(enabled)`	`CheckboxItem`	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)`	`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 `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Đặt xác thực dữ liệu cho mục hộp đánh dấu này.
`showOtherOption(enabled)`	`CheckboxItem`	Đặt liệu mục có tuỳ chọn "other" 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 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 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

`createChoice(value)`

Tạo lựa chọn mới.

Các tham số

Tên	Loại	Nội dung mô tả
`value`	`String`	giá trị của lựa chọn mà người trả lời sẽ nhìn 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 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

`createChoice(value, isCorrect)`

Tạo lựa chọn mới.

Các tham số

Tên	Loại	Nội dung mô tả
`value`	`String`	giá trị của lựa chọn mà người trả lời sẽ nhìn thấy dưới dạng nhãn khi xem biểu mẫu
`isCorrect`	`Boolean`	liệu lựa chọn này 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

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

`createResponse(responses)`

Tạo ItemResponse mới cho mụ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 được kiểm tra. Gửi ngoại lệ nếu có bất kỳ giá trị nào không khớp với lựa chọn hợp lệ cho mục này, trừ phi bạn đặt showOtherOption(enabled) thành true.

Các tham số

Tên	Loại	Nội dung 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 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

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

`getChoices()`

Nhận tất cả lựa chọn cho một vật phẩm.

Cầu thủ trả bóng

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

Ủ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

`getFeedbackForCorrect()`

Trả về phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho 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 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

`getFeedbackForIncorrect()`

Trả về phản hồi được 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

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

`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

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

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

`hasOtherOption()`

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ó lựa chọn "other"; false nếu không có lựa chọn này

Ủ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

`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']);

Các tham số

Tên	Loại	Nội dung 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 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

`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 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')
]);

Các tham số

Tên	Loại	Nội dung 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 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

`setFeedbackForCorrect(feedback)`

Đặt phản hồi được hiển thị cho người trả lời khi họ trả lời đúng cho 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());

Các tham số

Tên	Loại	Nội dung 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 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

`setFeedbackForIncorrect(feedback)`

Thiết lập phản hồi sẽ hiển thị cho người trả lời khi họ trả lời sai câu hỏi.

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

CheckboxItem — CheckboxItem 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

CheckboxItem — CheckboxItem 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

CheckboxItem — CheckboxItem 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

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

CheckboxItem — CheckboxItem 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

`setValidation(validation)`

Đặt xác thực dữ liệu cho mục hộp đánh dấu này. Việc chuyển giá trị rỗng hoặc xác thực mà không gọi hàm yêu cầu nào sẽ xoá mọi quy trình xác thực trước đó.

Các tham số

Tên	Loại	Nội dung mô tả
`validation`	`CheckboxValidation`	xác thực một 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 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

`showOtherOption(enabled)`

Đặt liệu mục có tuỳ chọn "other" hay không. Tuỳ chọn mặc định cho CheckboxItem hoặc MultipleChoiceItem mới là false.

Các tham số

Tên	Loại	Nội dung mô tả
`enabled`	`Boolean`	`true` nếu mục có tuỳ chọn "other"; `false` nếu không có tuỳ chọn

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