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 trong Form
.
Để thao tác trên các thuộc tính dành riêng cho từng loại, hãy sử dụng getType()
để kiểm tra ItemType
của mục, sau đó truyền mục đó đến lớp phù hợp bằng 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 học
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ục 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ột 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ột mục hình ảnh. |
asListItem() | ListItem | Trả về mục dưới dạng một mục danh sách. |
asMultipleChoiceItem() | MultipleChoiceItem | Trả về mục dưới dạng 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 văn bản. |
asScaleItem() | ScaleItem | Trả về một mục dưới dạng một tỷ lệ. |
asSectionHeaderItem() | SectionHeaderItem | Trả về mục dưới dạng mục trong 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ột 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 và thêm mục 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 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 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 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ục lưới có hộp đánh dấu. Gửi một ngoại lệ cho 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 có hộp đánh dấu
Gửi
Error
– nếu mục đó không phải là mục lưới có hộp đánh dấu
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 có hộp đánh dấu. Gửi một ngoại lệ cho 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 có hộp đánh dấu
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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ệ cho 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 này 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 cần đượ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ệ cho 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
Tập lệnh sử dụng phương thức này cần đượ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ột mục thời lượng. Gửi một ngoại lệ cho 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
Tập lệnh sử dụng phương thức này cần đượ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ệ cho 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 lưới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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()
asListItem()
Trả về mục dưới dạng một mục danh sách. Gửi một ngoại lệ cho 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ột mục trong danh sách
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 trắc nghiệm. Gửi một ngoại lệ cho 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 trắc nghiệm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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ệ cho 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 này 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 cần đượ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 dạng đoạn văn bản. Gửi một ngoại lệ cho 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 bằng đoạn văn bản
Gửi
Error
– nếu mục đó không phải là mục văn bản dạng đoạn văn bản
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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ột mục dưới dạng một tỷ lệ. Gửi một ngoại lệ cho 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 tỷ lệ
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 trong tiêu đề mục. Gửi một ngoại lệ cho 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 đề mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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ệ cho 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
Tập lệnh sử dụng phương thức này cần đượ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ột mục thời gian. Gửi một ngoại lệ cho 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
Tập lệnh sử dụng phương thức này cần đượ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()
duplicate()
getHelpText()
Lấy 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ục
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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ã nhận dạng của mặt hàng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
Tập lệnh sử dụng phương thức này cần đượ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 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ục
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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()
setHelpText(text)
Đặt 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ác tham số
Tên | Loại | Nội dung 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 cần đượ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 SectionHeaderItem
).
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | tiêu đề hoặc văn bản 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 cần đượ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