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ข้อความช่วยเหลือใหม่

รีเทิร์น

Item — Item นี้สำหรับการทำห่วงโซ่

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

Item — Item นี้สำหรับการทำห่วงโซ่

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

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

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