Class ListItem

ListItem

รายการคำถามที่อนุญาตให้ผู้ตอบเลือกตัวเลือกเดียวจากรายการแบบเลื่อนลง เข้าถึงหรือสร้างรายการจาก Form ได้

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
createChoice(value)	Choice	สร้างตัวเลือกใหม่
createChoice(value, isCorrect)	Choice	สร้างตัวเลือกใหม่
createChoice(value, navigationItem)	Choice	สร้างทางเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้าเว็บซึ่งจะข้ามไปยังรายการการแบ่งหน้าที่กำหนด
createChoice(value, navigationType)	Choice	สร้างตัวเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้า
createResponse(response)	ItemResponse	สร้าง ItemResponse ใหม่สำหรับรายการในลิสต์นี้
duplicate()	ListItem	สร้างสำเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม
getChoices()	Choice[]	รับตัวเลือกทั้งหมดสำหรับสินค้า
getFeedbackForCorrect()	QuizFeedback	แสดงผลความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง
getFeedbackForIncorrect()	QuizFeedback	แสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง
getHelpText()	String	รับข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
getId()	Integer	รับตัวระบุที่ไม่ซ้ำกันของรายการ
getIndex()	Integer	รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม
getPoints()	Integer	แสดงผลคะแนนของงานที่มีคะแนน
getTitle()	String	รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)
getType()	ItemType	รับประเภทของรายการซึ่งแสดงเป็น ItemType
isRequired()	Boolean	กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setChoiceValues(values)	ListItem	ตั้งค่าตัวเลือกสำหรับรายการจากอาร์เรย์สตริง
setChoices(choices)	ListItem	ตั้งค่าอาร์เรย์ตัวเลือกสําหรับสินค้า
setFeedbackForCorrect(feedback)	ListItem	ตั้งค่าการแสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง
setFeedbackForIncorrect(feedback)	ListItem	ตั้งค่าให้แสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง
setHelpText(text)	ListItem	ตั้งค่าข้อความความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
setPoints(points)	ListItem	กำหนดจำนวนคะแนนของงานที่ให้คะแนนได้
setRequired(enabled)	ListItem	ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
setTitle(title)	ListItem	ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)

เอกสารประกอบโดยละเอียด

createChoice(value)

สร้างตัวเลือกใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	String	ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม

รีเทิร์น

Choice — ตัวเลือกใหม่

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

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

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

---

createChoice(value, isCorrect)

สร้างตัวเลือกใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	String	ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม
isCorrect	Boolean	ตัวเลือกเป็นคำตอบที่ถูกต้องหรือไม่

รีเทิร์น

Choice — ตัวเลือกใหม่

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

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

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

---

createChoice(value, navigationItem)

สร้างทางเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้าเว็บซึ่งจะข้ามไปยังรายการการแบ่งหน้าที่กำหนด การดำเนินการนี้เทียบเท่ากับ createChoice(value, navigationType) ซึ่งตั้งค่า navigationType เป็น FormApp.PageNavigationType.GO_TO_PAGE ตัวเลือกที่ใช้การนําทางด้านหน้าจะรวมไว้ในรายการเดียวกันกับตัวเลือกที่ไม่ใช้การนําทางด้านหน้าไม่ได้

การนําทางหน้าเว็บจะเกิดขึ้นหลังจากที่ผู้ตอบตอบหน้าเว็บที่มีตัวเลือกนั้นเสร็จสิ้นแล้ว และในกรณีที่ผู้ตอบเลือกตัวเลือกนั้นเท่านั้น หากผู้ตอบเลือกตัวเลือกหลายรายการที่มีวิธีการไปยังส่วนต่างๆ ของหน้าในหน้าเดียวกัน จะมีผลเฉพาะตัวเลือกการไปยังส่วนต่างๆ รายการล่าสุดเท่านั้น นอกจากนี้ การไปยังส่วนต่างๆ ของหน้าเว็บจะไม่มีผลกับหน้าสุดท้ายของแบบฟอร์ม

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	String	ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม
navigationItem	PageBreakItem	รายการที่จะไปยัง

รีเทิร์น

Choice — ตัวเลือกใหม่

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

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

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

---

createChoice(value, navigationType)

สร้างตัวเลือกใหม่ที่มีตัวเลือกการไปยังส่วนต่างๆ ของหน้า ตัวเลือกที่ใช้การนําทางหน้าเว็บจะรวมไว้ในรายการเดียวกันกับตัวเลือกที่ไม่ใช้การนําทางหน้าเว็บไม่ได้

การนําทางหน้าเว็บจะเกิดขึ้นหลังจากที่ผู้ตอบตอบหน้าเว็บที่มีตัวเลือกนั้นเสร็จสิ้นแล้ว และในกรณีที่ผู้ตอบเลือกตัวเลือกนั้นเท่านั้น หากผู้ตอบเลือกตัวเลือกหลายรายการที่มีวิธีการไปยังส่วนต่างๆ ของหน้าในหน้าเดียวกัน จะมีผลเฉพาะตัวเลือกการไปยังส่วนต่างๆ รายการล่าสุดเท่านั้น นอกจากนี้ การไปยังส่วนต่างๆ ของหน้าเว็บจะไม่มีผลกับหน้าสุดท้ายของแบบฟอร์ม

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	String	ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกํากับเมื่อดูแบบฟอร์ม
navigationType	PageNavigationType	ประเภทการนําทางของตัวเลือก

รีเทิร์น

Choice — ตัวเลือกใหม่

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

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

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

---

createResponse(response)

สร้าง ItemResponse ใหม่สำหรับรายการในลิสต์นี้ แสดงข้อยกเว้นหากอาร์กิวเมนต์ response ไม่ตรงกับตัวเลือกที่ถูกต้องสำหรับรายการนี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
response	String	คำตอบที่ถูกต้องสำหรับรายการในลิสต์นี้

รีเทิร์น

ItemResponse — การตอบกลับรายการ

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

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

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

---

duplicate()

สร้างสำเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม

รีเทิร์น

ListItem — รายการ ListItem รายการนี้ซ้ำกันสำหรับใช้ต่อท้าย

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

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

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

---

getChoices()

รับตัวเลือกทั้งหมดสำหรับสินค้า

รีเทิร์น

Choice[] — อาร์เรย์ของตัวเลือก

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

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

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

---

getFeedbackForCorrect()

แสดงผลความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง

รีเทิร์น

QuizFeedback — ความคิดเห็น (หากมี)

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

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

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

---

getFeedbackForIncorrect()

แสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง

รีเทิร์น

QuizFeedback — ความคิดเห็น (หากมี)

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

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 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

---

getPoints()

แสดงผลคะแนนของงานที่มีคะแนน

รีเทิร์น

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

---

isRequired()

กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่

รีเทิร์น

Boolean — ผู้ตอบต้องตอบคำถามหรือไม่

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

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

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

---

setChoiceValues(values)

ตั้งค่าตัวเลือกสำหรับรายการจากอาร์เรย์สตริง โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่า

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
values	String[]	อาร์เรย์ของค่าตัวเลือกที่ผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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

---

setChoices(choices)

ตั้งค่าอาร์เรย์ตัวเลือกสําหรับสินค้า โยนข้อยกเว้นหากอาร์เรย์ที่ระบุว่างเปล่าหรือมีองค์ประกอบ null

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
choices	Choice[]	ตัวเลือกมากมาย

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

โยน

Error — หากอาร์เรย์ที่ระบุเป็น null ว่าง หรือมีองค์ประกอบ null

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

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

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

---

setFeedbackForCorrect(feedback)

ตั้งค่าการแสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
feedback	QuizFeedback	ความคิดเห็นใหม่ ค่า Null จะล้างความคิดเห็น

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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

---

setFeedbackForIncorrect(feedback)

ตั้งค่าให้แสดงความคิดเห็นต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
feedback	QuizFeedback	ความคิดเห็นใหม่

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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

---

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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

---

setPoints(points)

กำหนดจำนวนคะแนนของงานที่ให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
points	Integer	จำนวนคะแนนของรายการคำถาม

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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

---

setRequired(enabled)

ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
enabled	Boolean	ผู้ตอบต้องตอบคำถามหรือไม่

รีเทิร์น

ListItem — รายการปัจจุบัน (สำหรับการต่อเชื่อม)

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

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

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

---

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

ListItem — ListItem นี้สําหรับการเชน

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

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

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