Class ListItem

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. Các mục có thể có thể truy cập hoặc tạo qua Form. 

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

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
createChoice(value)ChoiceTạo lựa chọn mới.
createChoice(value, isCorrect)ChoiceTạo lựa chọn mới.
createChoice(value, navigationItem)ChoiceTạ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 dấu ngắt trang nhất định.
createChoice(value, navigationType)ChoiceTạo lựa chọn mới bằng tuỳ chọn điều hướng trang.
createResponse(response)ItemResponseTạo ItemResponse mới cho mục trong danh sách này.
duplicate()ListItemTạo bản sao của mục này rồi thêm mục này vào cuối biểu mẫu.
getChoices()Choice[]Nhận tất cả các lựa chọn cho một mục.
getFeedbackForCorrect()QuizFeedbackTrả 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()QuizFeedbackTrả về phản hồi hiển thị cho người trả lời khi họ trả lời sai một câu hỏi.
getHelpText()StringNhận 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()IntegerLấy giá trị nhận dạng riêng biệ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 là SectionHeaderItem).
getType()ItemTypeLấy loại của mục, được biểu thị dưới dạng ItemType.
isRequired()BooleanXá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 từ một mảng chuỗi.
setChoices(choices)ListItemĐặt một mảng các lựa chọn cho một mặt hàng.
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)ListItemThiết lập 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 là SectionHeaderItem).

Tài liệu chi tiết

createChoice(value)

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

Tham số

TênLoạiMô tả
valueStringgiá trị của 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

Choice — lựa chọn mới

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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.

Tham số

TênLoạiMô tả
valueStringgiá trị của 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
isCorrectBooleancâu trả lời đó có đú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 yêu cầu ủy 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 có tuỳ chọn điều hướng trang chuyển đến một mục dấu ngắt trang nhất định. Chiến dịch này sẽ tương đương với createChoice(value, navigationType) với navigationType được đặt thành FormApp.PageNavigationType.GO_TO_PAGE. Các lựa chọn sử dụng trang không thể kết hợp thao tác điều hướng 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 điều hướng trang diễn ra sau khi người trả lời hoàn thành một trang có chứa tuỳ chọn, và chỉ khi người trả lời chọn phương án đó. Nếu người trả lời chọn nhiều tùy chọn với hướng dẫn điều hướng trang trên cùng một trang, chỉ có tuỳ chọn điều hướng cuối cùng có hiệu lực. Việ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ênLoạiMô tả
valueStringgiá trị của 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
navigationItemPageBreakItemmục cần chuyển đến

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 yêu cầu ủy 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 lựa chọn mới bằng tuỳ chọn điều hướng trang. Bạn không thể chọn các lựa chọn sử dụng tính năng điều hướng trang được kết hợp trong cùng một mục với các lựa chọn không sử dụng điều hướng trang.

Thao tác điều hướng trang diễn ra sau khi người trả lời hoàn thành một trang có chứa tuỳ chọn, và chỉ khi người trả lời chọn phương án đó. Nếu người trả lời chọn nhiều tùy chọn với hướng dẫn điều hướng trang trên cùng một trang, chỉ có tuỳ chọn điều hướng cuối cùng có hiệu lực. Việ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ênLoạiMô tả
valueStringgiá trị của 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
navigationTypePageNavigationTypeloạ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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 ItemResponse mới cho mục trong 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ênLoạiMô tả
responseStringmột 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ục

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 rồi thêm mục này vào cuối biểu mẫu.

Cầu thủ trả bóng

ListItem — một bản sao của ListItem này để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ả các lựa chọn cho một mục.

Cầu thủ trả bóng

Choice[] – một loạt các lựa chọn

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 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 yêu cầu ủy 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()

Nhận 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ặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 riêng biệt của mặt hàng.

Cầu thủ trả bóng

Integer – mã của mặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 yêu cầu ủy 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 tương xứng với một câu hỏi.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 là SectionHeaderItem).

Cầu thủ trả bóng

String – văn bản tiêu đề hoặc tiêu đề của mặt hàng

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 yêu cầu ủy 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 — 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 yêu cầu ủy 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']);

Tham số

TênLoạiMô tả
valuesString[]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

ListItem — ListItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đã cho 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')
]);

Tham số

TênLoạiMô tả
choicesChoice[]một loạt 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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.
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());

Tham số

TênLoạiMô tả
feedbackQuizFeedbackphản hồi mới. Giá trị rỗng sẽ xoá phản hồi.

Cầu thủ trả bóng

ListItem — ListItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ênLoạiMô tả
feedbackQuizFeedbackphản hồi mới

Cầu thủ trả bóng

ListItem — ListItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ênLoạiMô tả
textStringvă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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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)

Thiết lập 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ênLoạiMô tả
pointsIntegersố điểm của một mục trong câu hỏi

Cầu thủ trả bóng

ListItem — ListItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ênLoạiMô tả
enabledBooleanliệ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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 là SectionHeaderItem).

Tham số

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

Cầu thủ trả bóng

ListItem — ListItem này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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