Interface Item

รายการ

รายการแบบฟอร์มทั่วไปที่มีพร็อพเพอร์ตี้ที่ใช้ร่วมกันในทุกรายการ เช่น ชื่อและข้อความช่วยเหลือ คุณเข้าถึงหรือสร้างรายการจาก Form ได้

หากต้องการดำเนินการกับพร็อพเพอร์ตี้เฉพาะประเภท ให้ใช้ getType() เพื่อตรวจสอบ ItemType ของรายการ จากนั้นส่งรายการไปยัง คลาสที่เหมาะสมโดยใช้วิธีการ เช่น asCheckboxItem() 

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const 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แสดงผลรายการเป็นรายการข้อความแบบย่อหน้า
asRatingItem()RatingItemแสดงผลรายการเป็นรายการการให้คะแนน
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

asRatingItem()

แสดงผลรายการเป็นรายการการให้คะแนน ส่ง ScriptingException หาก ItemType ไม่ได้เป็น RATING อยู่แล้ว 

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

รีเทิร์น

RatingItem — รายการการจัดประเภท

ส่ง

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