Interface Item

Item

Một mục biểu mẫu chung chứa các thuộc tính chung cho tất cả các mục, chẳng hạn như tiêu đề và văn bản trợ giúp. Bạn có thể truy cập hoặc tạo các mục trong Form.

Để thao tác trên các thuộc tính dành riêng cho từng loại, hãy sử dụng getType() để kiểm tra ItemType của mục, sau đó truyền mục đó đến lớp phù hợp bằng phương thức như asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Triển khai lớp học

TênMô tả ngắn

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
asCheckboxGridItem()CheckboxGridItemTrả về mục dưới dạng mục lưới có hộp đánh dấu.
asCheckboxItem()CheckboxItemTrả về mục dưới dạng mục có hộp đánh dấu.
asDateItem()DateItemTrả về mục dưới dạng mục ngày.
asDateTimeItem()DateTimeItemTrả về mục dưới dạng mục ngày-giờ.
asDurationItem()DurationItemTrả về mục dưới dạng một mục thời lượng.
asGridItem()GridItemTrả về mục dưới dạng mục trong lưới.
asImageItem()ImageItemTrả về mục dưới dạng một mục hình ảnh.
asListItem()ListItemTrả về mục dưới dạng một mục danh sách.
asMultipleChoiceItem()MultipleChoiceItemTrả về mục dưới dạng mục trắc nghiệm.
asPageBreakItem()PageBreakItemTrả về mục dưới dạng mục ngắt trang.
asParagraphTextItem()ParagraphTextItemTrả về mục dưới dạng mục văn bản dạng đoạn văn bản.
asScaleItem()ScaleItemTrả về một mục dưới dạng một tỷ lệ.
asSectionHeaderItem()SectionHeaderItemTrả về mục dưới dạng mục trong tiêu đề mục.
asTextItem()TextItemTrả về mục dưới dạng mục văn bản.
asTimeItem()TimeItemTrả về mục dưới dạng một mục thời gian.
asVideoItem()VideoItemTrả về mục dưới dạng một mục video.
duplicate()ItemTạo bản sao của mục này và thêm mục vào cuối biểu mẫu.
getHelpText()StringLấ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, PageBreakItemsSectionHeaderItems).
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.
getTitle()StringLấ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()ItemTypeLấy loại của mục, được biểu thị dưới dạng ItemType.
setHelpText(text)ItemĐặ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, PageBreakItemsSectionHeaderItems).
setTitle(title)ItemĐặ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).

Tài liệu chi tiết

asCheckboxGridItem()

Trả về mục dưới dạng mục lưới có hộp đánh dấu. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là CHECKBOX_GRID.

Cầu thủ trả bóng

CheckboxGridItem – mục lưới có hộp đánh dấu

Gửi

Error – nếu mục đó không phải là mục lưới có hộp đánh dấu

Ủ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

asCheckboxItem()

Trả về mục dưới dạng mục có hộp đánh dấu. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là CHECKBOX.

Cầu thủ trả bóng

CheckboxItem – mục hộp đánh dấu

Gửi

Error – nếu mục đó không phải là mục có hộp đánh dấu

Ủ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

asDateItem()

Trả về mục dưới dạng mục ngày. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là DATE.

Cầu thủ trả bóng

DateItem – mục ngày

Gửi

Error – nếu mục này không phải là mục ngà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

asDateTimeItem()

Trả về mục dưới dạng mục ngày-giờ. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là DATETIME.

Cầu thủ trả bóng

DateTimeItem — mục ngày giờ

Gửi

Error – nếu mục không phải là mục ngày giờ

Ủ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

asDurationItem()

Trả về mục dưới dạng một mục thời lượng. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là DURATION.

Cầu thủ trả bóng

DurationItem – mục thời lượng

Gửi

Error – nếu mục không phải là mục thời lượ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

asGridItem()

Trả về mục dưới dạng mục trong lưới. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là GRID.

Cầu thủ trả bóng

GridItem – mục trong lưới

Gửi

Error – nếu mục không phải là mục lướ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

asImageItem()

Trả về mục dưới dạng một mục hình ảnh. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là IMAGE.

Cầu thủ trả bóng

ImageItem – mục hình ảnh

Gửi

Error – nếu mục đó không phải là một mục hình ảnh


asListItem()

Trả về mục dưới dạng một mục danh sách. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là LIST.

Cầu thủ trả bóng

ListItem – mục danh sách

Gửi

Error – nếu mục đó không phải là một mục trong danh sách

Ủ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

asMultipleChoiceItem()

Trả về mục dưới dạng mục trắc nghiệm. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là MULTIPLE_CHOICE.

Cầu thủ trả bóng

MultipleChoiceItem — mục trắc nghiệm

Gửi

Error – nếu mục không phải là mục trắc nghiệm

Ủ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

asPageBreakItem()

Trả về mục dưới dạng mục ngắt trang. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là PAGE_BREAK.

Cầu thủ trả bóng

PageBreakItem – mục ngắt trang

Gửi

Error – nếu mục này không phải là mục ngắt trang

Ủ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

asParagraphTextItem()

Trả về mục dưới dạng mục văn bản dạng đoạn văn bản. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là PARAGRAPH_TEXT.

Cầu thủ trả bóng

ParagraphTextItem – mục văn bản bằng đoạn văn bản

Gửi

Error – nếu mục đó không phải là mục văn bản dạng đoạn văn bả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

asScaleItem()

Trả về một mục dưới dạng một tỷ lệ. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là SCALE.

Cầu thủ trả bóng

ScaleItem – mục tỷ lệ

Gửi

Error – nếu mục không phải là mục tỷ lệ

Ủ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

asSectionHeaderItem()

Trả về mục dưới dạng mục trong tiêu đề mục. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là SECTION_HEADER.

Cầu thủ trả bóng

SectionHeaderItem – mục tiêu đề mục

Gửi

Error – nếu mục không phải là mục tiêu đề 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

asTextItem()

Trả về mục dưới dạng mục văn bản. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là TEXT.

Cầu thủ trả bóng

TextItem – mục văn bản

Gửi

Error – nếu mục đó không phải là mục văn bả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

asTimeItem()

Trả về mục dưới dạng một mục thời gian. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là TIME.

Cầu thủ trả bóng

TimeItem – mục thời gian

Gửi

Error – nếu mục không phải là mục thời gian

Ủ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

asVideoItem()

Trả về mục dưới dạng một mục video. Gửi một ngoại lệ cho tập lệnh nếu ItemType chưa phải là VIDEO.

Cầu thủ trả bóng

VideoItem – mục video

Gửi

Error – nếu mục đó không phải là mục video


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

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

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, PageBreakItemsSectionHeaderItems).

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

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

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, PageBreakItemsSectionHeaderItems).

Các tham số

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

Cầu thủ trả bóng

ItemItem 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

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ênLoạiNội dung mô tả
titleStringtiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

ItemItem 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