Class CheckboxItem

Hộp đánh dấuMục

Một 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 "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 dùng trong bài kiểm tra, các mục này sẽ được chấm điểm tự động. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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ứcKiểu dữ liệu trả vềMô tả ngắn
clearValidation()CheckboxItemXoá mọi quy tắc xác thực dữ liệu cho mục hộp đánh dấu này.
createChoice(value)ChoiceTạo một lựa chọn mới.
createChoice(value, isCorrect)ChoiceTạo một lựa chọn mới.
createResponse(responses)ItemResponseTạo một ItemResponse mới cho mục hộp đánh dấu này.
duplicate()CheckboxItemTạ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|nullTrả về thông tin phản hồi mà người trả lời nhìn thấy khi họ trả lời đúng một câu hỏi.
getFeedbackForIncorrect()QuizFeedback|nullTrả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời sai một câu hỏi.
getHelpText()StringLấ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()IntegerLấy giá trị nhận dạng duy nhất của mặt hàng.
getIndex()IntegerLấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
getPoints()IntegerTrả về giá trị điểm của một mục có thể chấm điểm.
getTitle()StringLấ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).
getType()ItemTypeLấy loại của mục, được biểu thị dưới dạng ItemType.
hasOtherOption()BooleanXác định xem mục có lựa chọn "khác" hay không.
isRequired()BooleanXá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.
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ục.
setFeedbackForCorrect(feedback)CheckboxItemĐặt thông tin 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)CheckboxItemĐặt thông tin 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)CheckboxItemĐặ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)CheckboxItemĐặt số điểm tương ứng cho một mục có thể chấm điểm.
setRequired(enabled)CheckboxItemĐặt xem người trả lời có bắt buộ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 quy tắc xác thực dữ liệu cho mục hộp đánh dấu này.
showOtherOption(enabled)CheckboxItemĐặt xem mặt hàng có lựa chọn "khác" hay không.

Tài liệu chi tiết

clearValidation()

Xoá mọi quy tắc 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, để 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

createChoice(value)

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

Thông số

TênLoạiMô tả
valueStringgiá 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 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

createChoice(value, isCorrect)

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

Thông số

TênLoạiMô tả
valueStringgiá 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
isCorrectBooleanlự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 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

createResponse(responses)

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

Thông số

TênLoạiMô tả
responsesString[]một mảng 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 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 vào cuối biểu mẫu.

Cầu thủ trả bóng

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

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

getFeedbackForCorrect()

Trả về thông tin phản hồi mà người trả lời nhìn thấy khi họ trả lời đúng một câu hỏi.

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

getFeedbackForIncorrect()

Trả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời sai một câu hỏi.

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

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

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

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

hasOtherOption()

Xác định xem mục có lựa chọn "khác" hay không.

Cầu thủ trả bóng

Boolean – true nếu mục có lựa 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 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

setChoiceValues(values)

Đặt các lựa chọn cho một mục từ một mảng chuỗi. Trả về một trường hợp ngoại lệ nếu mảng đã cho bị 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']);

Thông số

TênLoạiMô tả
valuesString[]mảng giá trị lựa chọn mà người trả lời nhìn thấy dưới dạng nhãn khi xem biểu mẫu

Cầu thủ trả bóng

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

setChoices(choices)

Đặt một mảng các lựa chọn cho một mục. Trả về một ngoại lệ nếu mảng đã cho bị trống hoặc chứa một 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')]);

Thông số

TênLoạiMô tả
choicesChoice[]một mảng các lựa chọn

Cầu thủ trả bóng

CheckboxItem – CheckboxItem này, để xâu chuỗi

Gửi

Error – nếu mảng đã cho là null, rỗng hoặc chứa một phần tử null

Ủ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

setFeedbackForCorrect(feedback)

Đặt thông tin 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(),
);

Thông số

TênLoạiMô tả
feedbackQuizFeedbacký 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

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

setFeedbackForIncorrect(feedback)

Đặt thông tin 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.

Thông số

TênLoạiMô tả
feedbackQuizFeedbacký kiến phản hồi mới

Cầu thủ trả bóng

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

Thông số

TênLoạiMô tả
textStringvăn bản trợ giúp mới

Cầu thủ trả bóng

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

Thông số

TênLoạiMô tả
pointsIntegersố điểm tương ứng với một câu hỏi

Cầu thủ trả bóng

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

Thông số

TênLoạiMô tả
enabledBooleanngườ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

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

Thông số

TênLoạiMô tả
titleStringtiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

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

setValidation(validation)

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

Thông số

TênLoạiMô tả
validationCheckboxValidationmột CheckboxValidation để áp dụng cho mục này.

Cầu thủ trả bóng

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

showOtherOption(enabled)

Đặt xem mặt hàng có lựa chọn "khác" hay không. Giá trị mặc định cho CheckboxItem hoặc MultipleChoiceItem mới là false.

Thông số

TênLoạiMô tả
enabledBooleantrue nếu mục có lựa chọn "khác"; false nếu không

Cầu thủ trả bóng

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