รายการแบบฟอร์มทั่วไปซึ่งมีคุณสมบัติทั่วไปในรายการทั้งหมด เช่น ชื่อและข้อความช่วยเหลือ
คุณจะเข้าถึงหรือสร้างรายการได้จาก 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
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ข้อความช่วยเหลือใหม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
title | String | ชื่อหรือข้อความส่วนหัวใหม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms