Interface Item

รายการ

รายการแบบฟอร์มทั่วไปที่มีพร็อพเพอร์ตี้ที่ใช้กับรายการทั้งหมดได้ เช่น ชื่อและข้อความช่วยเหลือ คุณสามารถเข้าถึงหรือสร้างรายการได้จาก 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()

คืนสินค้าเป็นรายการรูปภาพ ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType ยังไม่ใช่ IMAGE

ไปกลับ

ImageItem — รายการรูปภาพ

ผ้าคลุม

Error — หากสินค้าไม่ใช่รายการรูปภาพ


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

คืนสินค้าในรูปแบบวิดีโอ ส่งสคริปต์ที่ได้รับการยกเว้นหาก ItemType ยังไม่ใช่ VIDEO

ไปกลับ

VideoItem — รายการวิดีโอ

ผ้าคลุม

Error — หากรายการไม่ใช่รายการวิดีโอ


duplicate()

สร้างสําเนาของรายการนี้และต่อท้ายแบบฟอร์ม

ไปกลับ

Item — เป็นรายการซ้ําของ Item นี้สําหรับเชนธุรกิจ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

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

รับประเภทรายการซึ่งแสดงเป็น ItemType

ไปกลับ

ItemType — ประเภทของรายการ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setHelpText(text)

ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคําอธิบายสําหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความช่วยเหลือใหม่

ไปกลับ

ItemItem นี้สําหรับเชนธุรกิจ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTitle(title)

ตั้งชื่อของสินค้า (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีที่เป็น SectionHeaderItem)

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringชื่อหรือข้อความส่วนหัวใหม่

ไปกลับ

ItemItem นี้สําหรับเชนธุรกิจ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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