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()
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()
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()
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
Ủ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
Ủ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