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

Interface 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ên	Mô tả ngắn

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`asCheckboxGridItem()`	`CheckboxGridItem`	Trả về mục dưới dạng mục trong lưới có hộp đánh dấu.
`asCheckboxItem()`	`CheckboxItem`	Trả về mục dưới dạng mục có hộp đánh dấu.
`asDateItem()`	`DateItem`	Trả về mục dưới dạng mục ngày.
`asDateTimeItem()`	`DateTimeItem`	Trả về mục dưới dạng mục ngày giờ.
`asDurationItem()`	`DurationItem`	Trả về mục dưới dạng mục thời lượng.
`asGridItem()`	`GridItem`	Trả về mục dưới dạng một mục trong lưới.
`asImageItem()`	`ImageItem`	Trả về mục dưới dạng một mục hình ảnh.
`asListItem()`	`ListItem`	Trả về mục dưới dạng một mục trong danh sách.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Trả về mục dưới dạng một mục trắc nghiệm.
`asPageBreakItem()`	`PageBreakItem`	Trả về mục dưới dạng mục ngắt trang.
`asParagraphTextItem()`	`ParagraphTextItem`	Trả về mục dưới dạng mục văn bản dạng đoạn.
`asScaleItem()`	`ScaleItem`	Trả về mục dưới dạng một mục tỷ lệ.
`asSectionHeaderItem()`	`SectionHeaderItem`	Trả về mục dưới dạng mục tiêu đề mục.
`asTextItem()`	`TextItem`	Trả về mục dưới dạng mục văn bản.
`asTimeItem()`	`TimeItem`	Trả về mục dưới dạng mục thời gian.
`asVideoItem()`	`VideoItem`	Trả về mục dưới dạng một mục video.
`duplicate()`	`Item`	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.
`getHelpText()`	`String`	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`).
`getId()`	`Integer`	Lấy giá trị nhận dạng riêng biệ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.
`getTitle()`	`String`	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`).
`getType()`	`ItemType`	Lấ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`, `PageBreakItems` và `SectionHeaderItems`).
`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, 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

`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, PageBreakItems và SectionHeaderItems).

Tham số

Tên	Loại	Mô tả
`text`	`String`	văn bản trợ giúp mới

Cầu thủ trả bóng

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

`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ên	Loại	Mô tả
`title`	`String`	văn bản tiêu đề hoặc tiêu đề mới

Cầu thủ trả bóng

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