รายการแบบฟอร์มทั่วไปที่มีพร็อพเพอร์ตี้ที่ใช้กับรายการทั้งหมดได้ เช่น ชื่อและข้อความช่วยเหลือ
คุณสามารถเข้าถึงหรือสร้างรายการได้จาก Form
หากต้องการดําเนินการในพร็อพเพอร์ตี้เฉพาะประเภท ให้ใช้ getType()
เพื่อตรวจสอบ ItemType
ของรายการดังกล่าว จากนั้นแคสต์รายการไปยังคลาสที่เหมาะสมโดยใช้เมธอด เช่น 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); }
การนําชั้นเรียนไปใช้
ชื่อ | รายละเอียดแบบย่อ |
---|
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
asCheckboxGridItem() | CheckboxGridItem | ส่งกลับรายการเป็นรายการแบบช่องทําเครื่องหมาย |
asCheckboxItem() | CheckboxItem | คืนสินค้าในรูปแบบช่องทําเครื่องหมาย |
asDateItem() | DateItem | คืนสินค้าเป็นรายการวันที่ |
asDateTimeItem() | DateTimeItem | คืนสินค้าเป็นรายการวันที่และเวลา |
asDurationItem() | DurationItem | คืนสินค้าเป็นรายการระยะเวลา |
asGridItem() | GridItem | แสดงผลรายการเป็นรายการตารางกริด |
asImageItem() | ImageItem | คืนสินค้าเป็นรายการรูปภาพ |
asListItem() | ListItem | แสดงผลรายการดังกล่าวเป็นรายการ |
asMultipleChoiceItem() | MultipleChoiceItem | แสดงผลรายการเป็นหลายตัวเลือก |
asPageBreakItem() | PageBreakItem | แสดงผลรายการดังกล่าวเป็นรายการตัวแบ่งหน้า |
asParagraphTextItem() | ParagraphTextItem | แสดงผลรายการเป็นรายการย่อหน้า |
asScaleItem() | ScaleItem | คืนสินค้าเป็นรายการขนาด |
asSectionHeaderItem() | SectionHeaderItem | แสดงผลรายการเป็นรายการส่วนหัว |
asTextItem() | TextItem | แสดงผลรายการเป็นรายการข้อความ |
asTimeItem() | TimeItem | แสดงผลรายการเป็นรายการเวลา |
asVideoItem() | VideoItem | คืนสินค้าในรูปแบบวิดีโอ |
duplicate() | Item | สร้างสําเนาของรายการนี้และต่อท้ายแบบฟอร์ม |
getHelpText() | String | รับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคําอธิบายสําหรับรายการเลย์เอาต์ เช่น ImageItems , PageBreakItems และ SectionHeaderItems ) |
getId() | Integer | รับตัวระบุที่ไม่ซ้ํากันของรายการ |
getIndex() | Integer | รับดัชนีรายการของสินค้าทั้งหมดในแบบฟอร์ม |
getTitle() | String | ดึงชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีที่เป็น SectionHeaderItem ) |
getType() | ItemType | รับประเภทรายการซึ่งแสดงเป็น ItemType |
setHelpText(text) | Item | ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคําอธิบายสําหรับรายการเลย์เอาต์ เช่น ImageItems , PageBreakItems และ SectionHeaderItems ) |
setTitle(title) | Item | ตั้งชื่อของสินค้า (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีที่เป็น SectionHeaderItem ) |
เอกสารประกอบโดยละเอียด
asCheckboxGridItem()
ส่งกลับรายการเป็นรายการแบบช่องทําเครื่องหมาย ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ CHECKBOX_GRID
ไปกลับ
CheckboxGridItem
— รายการแบบช่องทําเครื่องหมาย
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการแบบช่องทําเครื่องหมาย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asCheckboxItem()
คืนสินค้าในรูปแบบช่องทําเครื่องหมาย ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ CHECKBOX
ไปกลับ
CheckboxItem
— รายการในช่องทําเครื่องหมาย
ผ้าคลุม
Error
— หากรายการนั้นไม่ใช่ช่องทําเครื่องหมาย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateItem()
คืนสินค้าเป็นรายการวันที่ ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ DATE
ไปกลับ
DateItem
— รายการวันที่
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการวันที่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateTimeItem()
คืนสินค้าเป็นรายการวันที่และเวลา ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ DATETIME
ไปกลับ
DateTimeItem
— รายการวันที่และเวลา
ผ้าคลุม
Error
— หากรายการดังกล่าวไม่ใช่รายการวันที่และเวลา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDurationItem()
คืนสินค้าเป็นรายการระยะเวลา ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ DURATION
ไปกลับ
DurationItem
— รายการระยะเวลา
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการระยะเวลา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asGridItem()
แสดงผลรายการเป็นรายการตารางกริด ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ GRID
ไปกลับ
GridItem
— รายการแบบตารางกริด
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการตารางกริด
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asImageItem()
asListItem()
แสดงผลรายการดังกล่าวเป็นรายการ ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ LIST
ไปกลับ
ListItem
— รายการสินค้า
ผ้าคลุม
Error
— หากไม่ใช่รายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asMultipleChoiceItem()
แสดงผลรายการเป็นหลายตัวเลือก ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ MULTIPLE_CHOICE
ไปกลับ
MultipleChoiceItem
— รายการแบบหลายตัวเลือก
ผ้าคลุม
Error
— หากสินค้าไม่ใช่สินค้าแบบหลายตัวเลือก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asPageBreakItem()
แสดงผลรายการดังกล่าวเป็นรายการตัวแบ่งหน้า ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ PAGE_BREAK
ไปกลับ
PageBreakItem
— รายการตัวแบ่งหน้า
ผ้าคลุม
Error
— หากไม่ใช่รายการตัวแบ่งหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asParagraphTextItem()
แสดงผลรายการเป็นรายการย่อหน้า ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ PARAGRAPH_TEXT
ไปกลับ
ParagraphTextItem
— รายการย่อหน้าย่อหน้า
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการข้อความย่อหน้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asScaleItem()
คืนสินค้าเป็นรายการขนาด ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ SCALE
ไปกลับ
ScaleItem
— รายการปรับขนาด
ผ้าคลุม
Error
— หากไม่ใช่สินค้าในสเกล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asSectionHeaderItem()
แสดงผลรายการเป็นรายการส่วนหัว ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ SECTION_HEADER
ไปกลับ
SectionHeaderItem
— รายการส่วนส่วนหัว
ผ้าคลุม
Error
— หากรายการนั้นไม่ใช่รายการส่วนหัวของส่วน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTextItem()
แสดงผลรายการเป็นรายการข้อความ ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ TEXT
ไปกลับ
TextItem
— รายการข้อความ
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTimeItem()
แสดงผลรายการเป็นรายการเวลา ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType
ยังไม่ใช่ TIME
ไปกลับ
TimeItem
— รายการเวลา
ผ้าคลุม
Error
— หากรายการไม่ใช่รายการเวลา
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asVideoItem()
duplicate()
getHelpText()
รับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคําอธิบายสําหรับรายการเลย์เอาต์ เช่น ImageItems
, PageBreakItems
และ SectionHeaderItems
)
ไปกลับ
String
— ข้อความช่วยเหลือหรือข้อความคําอธิบายของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
รับตัวระบุที่ไม่ซ้ํากันของรายการ
ไปกลับ
Integer
— รหัสของ'
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
รับดัชนีรายการของสินค้าทั้งหมดในแบบฟอร์ม
ไปกลับ
Integer
— ดัชนีของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
ดึงชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีที่เป็น SectionHeaderItem
)
ไปกลับ
String
— ชื่อหรือข้อความส่วนหัวของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
setHelpText(text)
ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคําอธิบายสําหรับรายการเลย์เอาต์ เช่น ImageItems
, PageBreakItems
และ SectionHeaderItems
)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความช่วยเหลือใหม่ |
ไปกลับ
Item
— Item
นี้สําหรับเชนธุรกิจ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
ตั้งชื่อของสินค้า (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีที่เป็น SectionHeaderItem
)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | ชื่อหรือข้อความส่วนหัวใหม่ |
ไปกลับ
Item
— Item
นี้สําหรับเชนธุรกิจ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms