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)

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringข้อความช่วยเหลือใหม่

รีเทิร์น

ItemItem นี้สำหรับการทำเชน

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

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

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

setTitle(title)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
titleStringชื่อหรือข้อความส่วนหัวใหม่

รีเทิร์น

ItemItem นี้สำหรับการทำเชน

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

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

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