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 dành riêng cho loại, hãy 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 cách dù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 các lớp

Tên	Mô tả ngắn

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`asCheckboxGridItem()`	`CheckboxGridItem`	Trả về mục dưới dạng một mục trong lưới hộp đánh dấu.
`asCheckboxItem()`	`CheckboxItem`	Trả về mục dưới dạng một mục trong 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ụ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.
`asRatingItem()`	`RatingItem`	Trả về mục dưới dạng một mục xếp hạng.
`asScaleItem()`	`ScaleItem`	Trả về mục dưới dạng một mục trên thang đo.
`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ột 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ục video.
`duplicate()`	`Item`	Tạo một bản sao của mục này và thêm bản sao đó 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 `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 `SectionHeaderItem`).

Tài liệu chi tiết

`asCheckboxGridItem()`

Trả về mục dưới dạng một mục trong lưới hộp đánh dấu. Trả về một ngoại lệ kịch bản 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 trong 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asCheckboxItem()`

Trả về mục dưới dạng một mục trong hộp đánh dấu. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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ờ. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 có thời lượng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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ột mục trong danh sách. Trả về một ngoại lệ kịch bản nếu ItemType chưa 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asRatingItem()`

Trả về mục dưới dạng một mục xếp hạng. Gửi 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 phân loại.

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 trên thang đo. Trả về một ngoại lệ kịch bản nếu ItemType chưa phải là SCALE.

Cầu thủ trả bóng

ScaleItem – mục thang đo

Gửi

Error – nếu mục không phải là mục có thể điều chỉnh tỷ lệ

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asTextItem()`

Trả về mục dưới dạng một mục văn bản. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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. Trả về một ngoại lệ kịch bản 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`asVideoItem()`

Trả về mục dưới dạng mục video. Trả về một ngoại lệ kịch bản 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 bản sao đó vào cuối biểu mẫu.

Cầu thủ trả bóng

Item – bản sao của Item này, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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 SectionHeaderItem).

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Thông 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, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

Thông 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, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

Interface Item Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Triển khai các lớp

Phương thức

Tài liệu chi tiết

asCheckboxGridItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asCheckboxItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asDateItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asDateTimeItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asDurationItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asGridItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asImageItem()

Cầu thủ trả bóng

Gửi

asListItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asMultipleChoiceItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asPageBreakItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asParagraphTextItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asRatingItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asScaleItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asSectionHeaderItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asTextItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asTimeItem()

Cầu thủ trả bóng

Gửi

Ủy quyền

asVideoItem()

Cầu thủ trả bóng

Gửi

duplicate()

Cầu thủ trả bóng

Ủy quyền

getHelpText()

Cầu thủ trả bóng

Ủy quyền

getId()

Cầu thủ trả bóng

Ủy quyền

getIndex()

Interface Item

`asCheckboxGridItem()`

`asCheckboxItem()`

`asDateItem()`

`asDateTimeItem()`

`asDurationItem()`

`asGridItem()`

`asImageItem()`

`asListItem()`

`asMultipleChoiceItem()`

`asPageBreakItem()`

`asParagraphTextItem()`

`asRatingItem()`

`asScaleItem()`

`asSectionHeaderItem()`

`asTextItem()`

`asTimeItem()`

`asVideoItem()`

`duplicate()`

`getHelpText()`

`getId()`

`getIndex()`

`getTitle()`

`getType()`

`setHelpText(text)`

`setTitle(title)`