รายการคําถามที่ช่วยให้ผู้ตอบเลือก 1 ตัวเลือกจากรายการแบบเลื่อนลงได้ คุณสามารถเข้าถึงหรือสร้างรายการได้จาก Form
// Open a form by ID and add a new list item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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
createResponse(response)
สร้าง ItemResponse
ใหม่สําหรับรายการนี้ แสดงผลข้อยกเว้นหากอาร์กิวเมนต์ response
ไม่ตรงกับตัวเลือกที่ถูกต้องสําหรับรายการนี้
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
response | String | คําตอบที่ถูกต้องสําหรับรายการนี้ |
ไปกลับ
ItemResponse
— การตอบกลับสินค้า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีนี้ต้องได้รับสิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
getChoices()
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()
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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var 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 | ความคิดเห็นใหม่ ค่าว่างจะล้างความคิดเห็น |
ไปกลับ
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