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 từ Form.

Để thao tác trên các thuộc tính cụ thể cho từng loại, hãy sử dụng getType() để kiểm tra ItemType của mục, sau đó truyền mục đó tới một lớp thích hợp bằng một 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

TênMô tả ngắn

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
asCheckboxGridItem()CheckboxGridItemTrả về mục dưới dạng mục trong 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ục thời lượng.
asGridItem()GridItemTrả về mục dưới dạng một 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 trong danh sách.
asMultipleChoiceItem()MultipleChoiceItemTrả về mục dưới dạng một 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.
asScaleItem()ScaleItemTrả về mục dưới dạng một mục tỷ lệ.
asSectionHeaderItem()SectionHeaderItemTrả về mục dưới dạng mục 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ụ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 rồi thêm mục này vào cuối biểu mẫu.
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, PageBreakItemsSectionHeaderItems).
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.
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.
setHelpText(text)ItemĐặ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, 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 là SectionHeaderItem).

Tài liệu chi tiết

asCheckboxGridItem()

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

Cầu thủ trả bóng

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

Gửi

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

Ủ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

asCheckboxItem()

Trả về mục dưới dạng mục có hộp đánh dấu. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 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

asDateItem()

Trả về mục dưới dạng mục ngày. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là DATE.

Cầu thủ trả bóng

DateItem – mục ngày

Gửi

Error – nếu mục đó 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 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

asDateTimeItem()

Trả về mục dưới dạng mục ngày giờ. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 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

asDurationItem()

Trả về mục dưới dạng mục thời lượng. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 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

asGridItem()

Trả về mục dưới dạng một mục trong lưới. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 trong lướ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

asImageItem()

Trả về mục dưới dạng một mục hình ảnh. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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ục hình ảnh


asListItem()

Trả về mục dưới dạng một mục trong danh sách. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là LIST.

Cầu thủ trả bóng

ListItem – mục trong 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 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

asMultipleChoiceItem()

Trả về mục dưới dạng một mục trắc nghiệm. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 nhiều 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

asPageBreakItem()

Trả về mục dưới dạng mục ngắt trang. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là PAGE_BREAK.

Cầu thủ trả bóng

PageBreakItem — mục ngắt trang

Gửi

Error – nếu mục đó 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 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

asParagraphTextItem()

Trả về mục dưới dạng mục văn bản dạng đoạn. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là PARAGRAPH_TEXT.

Cầu thủ trả bóng

ParagraphTextItem — mục văn bản dạng đoạn

Gửi

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

asScaleItem()

Trả về mục dưới dạng một mục tỷ lệ. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là SCALE.

Cầu thủ trả bóng

ScaleItem – mục trên tỷ lệ

Gửi

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

Ủ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

asSectionHeaderItem()

Trả về mục dưới dạng mục tiêu đề mục. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không phải là SECTION_HEADER.

Cầu thủ trả bóng

SectionHeaderItem — mục tiêu đề phần

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

asTextItem()

Trả về mục dưới dạng mục văn bản. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 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

asTimeItem()

Trả về mục dưới dạng mục thời gian. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 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

asVideoItem()

Trả về mục dưới dạng một mục video. Gửi một trường hợp ngoại lệ về tập lệnh nếu ItemType không 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 rồi thêm mục này vào cuối biểu mẫu.

Cầu thủ trả bóng

Item — một 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 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, 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ặ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

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

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

Tham số

TênLoạiMô 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 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

ItemItem 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