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 phổ biến 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 dành riêng cho loại, hãy sử dụng getType() để kiểm tra ItemType của mục, sau đó truyền mục đó đến 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.
const form = FormApp.create('Form Name');
form.addTextItem();

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

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const 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 lưới hộp đánh dấu.
`asCheckboxItem()`	`CheckboxItem`	Trả về mục dưới dạng mụ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ục trong lưới.
`asImageItem()`	`ImageItem`	Trả về mục dưới dạng mục hình ảnh.
`asListItem()`	`ListItem`	Trả về mục dưới dạng mục danh sách.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Trả về mục dưới dạng mục nhiều lựa chọn.
`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 đoạn văn.
`asRatingItem()`	`RatingItem`	Trả về mục dưới dạng mục xếp hạng.
`asScaleItem()`	`ScaleItem`	Trả về mục dưới dạng mục theo tỷ lệ.
`asSectionHeaderItem()`	`SectionHeaderItem`	Trả về mục dưới dạng mục tiêu đề phần.
`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ặt hàng dưới dạng mặt hàng video.
`duplicate()`	`Item`	Tạo một bản sao của mục này và thêm vào cuối biểu mẫu.
`getHelpText()`	`String`	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`).
`getId()`	`Integer`	Lấy giá trị nhận dạng duy nhấ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 của `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 của `SectionHeaderItem`).

Tài liệu chi tiết

`asCheckboxGridItem()`

Trả về mục dưới dạng mục lưới hộp đánh dấu. Gửi một ngoại lệ 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 hộp đánh dấu

Gửi

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 hộp đánh dấu. Gửi một ngoại lệ 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 hộp đánh dấu

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ệ 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 không phải là mục ngày

Ủy quyền

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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ục thời lượng. Gửi một ngoại lệ 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ệ 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 trong lưới

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ục hình ảnh. Gửi một ngoại lệ 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ục hình ảnh

`asListItem()`

Trả về mục dưới dạng mục danh sách. Gửi một ngoại lệ 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ục trong danh sách

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 nhiều lựa chọn. Gửi một ngoại lệ 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 nhiều lựa chọn

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ệ 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 đó không phải là mục ngắt trang

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đoạn văn. Gửi một ngoại lệ 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 đoạn

Gửi

Error – nếu mục đó không phải là mục văn bản đoạn văn

Ủy quyền

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

`asRatingItem()`

Trả về mục dưới dạng mục xếp hạng. Gửi một ScriptingException nếu ItemType chưa phải là RATING.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

Cầu thủ trả bóng

RatingItem – Mục xếp hạng.

Gửi

Error – nếu mục đó không phải là mục xếp hạng

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ục dưới dạng mục theo tỷ lệ. Gửi một ngoại lệ 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 theo tỷ lệ

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 tiêu đề phần. Gửi một ngoại lệ 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 đề phần

Ủy quyền

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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ục thời gian. Gửi một ngoại lệ 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ặt hàng dưới dạng mặt hàng video. Gửi một ngoại lệ 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 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

Item – bản sao của Item này, để tạo chuỗi

Ủy quyền

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

Ủy quyền

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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 được gọi là văn bản tiêu đề, trong trường hợp của SectionHeaderItem).

Cầu thủ trả bóng

String – tiêu đề hoặc văn bản tiêu đề của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 của mục

Ủy quyền

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

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

Tham số

Tên	Loại	Mô tả
`title`	`String`	tiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

Item – Item này, để tạo chuỗi

Ủy quyền

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