รายการคําถามที่ให้ผู้ตอบเลือกช่องทําเครื่องหมายอย่างน้อย 1 ช่องและช่อง "อื่นๆ" ที่ไม่บังคับ คุณจะเข้าถึงหรือสร้างรายการได้จาก Form
เมื่อใช้ในแบบทดสอบ รายการเหล่านี้จะมีการให้คะแนนอัตโนมัติ
// Open a form by ID and add a new checkbox item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxItem(); item.setTitle('What condiments would you like on your hot dog?') .setChoices([ item.createChoice('Ketchup'), item.createChoice('Mustard'), item.createChoice('Relish') ]) .showOtherOption(true);
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
clearValidation() | CheckboxItem | นำการตรวจสอบข้อมูลสำหรับรายการช่องทำเครื่องหมายนี้ออก |
createChoice(value) | Choice | สร้างตัวเลือกใหม่ |
createChoice(value, isCorrect) | Choice | สร้างตัวเลือกใหม่ |
createResponse(responses) | ItemResponse | สร้าง ItemResponse ใหม่สำหรับรายการช่องทำเครื่องหมายนี้ |
duplicate() | CheckboxItem | สร้างสำเนาของรายการนี้และเพิ่มต่อท้ายแบบฟอร์ม |
getChoices() | Choice[] | รับตัวเลือกทั้งหมดของรายการหนึ่งๆ |
getFeedbackForCorrect() | QuizFeedback | แสดงผลตอบกลับที่จะปรากฏต่อผู้ตอบเมื่อตอบคำถามได้อย่างถูกต้อง |
getFeedbackForIncorrect() | QuizFeedback | แสดงผลฟีดแบ็กที่จะปรากฏต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง |
getHelpText() | String | รับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในเลย์เอาต์ เช่น ImageItems , PageBreakItems และ SectionHeaderItems ) |
getId() | Integer | รับตัวระบุที่ไม่ซ้ำกันของสินค้า |
getIndex() | Integer | รับดัชนีของรายการจากรายการทั้งหมดในแบบฟอร์ม |
getPoints() | Integer | แสดงผลค่าคะแนนของรายการที่ให้คะแนนได้ |
getTitle() | String | รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem ) |
getType() | ItemType | รับประเภทของรายการ ซึ่งแสดงเป็น ItemType |
hasOtherOption() | Boolean | ระบุว่ารายการมีตัวเลือก "อื่นๆ" หรือไม่ |
isRequired() | Boolean | กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่ |
setChoiceValues(values) | CheckboxItem | ตั้งค่าตัวเลือกสำหรับรายการจากอาร์เรย์ของสตริง |
setChoices(choices) | CheckboxItem | ตั้งค่าอาร์เรย์ของตัวเลือกสําหรับรายการ |
setFeedbackForCorrect(feedback) | CheckboxItem | ตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามถูกต้อง |
setFeedbackForIncorrect(feedback) | CheckboxItem | ตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง |
setHelpText(text) | CheckboxItem | ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในการจัดวาง เช่น ImageItems , PageBreakItems และ SectionHeaderItems ) |
setPoints(points) | CheckboxItem | กำหนดจำนวนคะแนนที่รายการให้คะแนนได้ |
setRequired(enabled) | CheckboxItem | ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่ |
setTitle(title) | CheckboxItem | ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem ) |
setValidation(validation) | CheckboxItem | ตั้งค่าการตรวจสอบข้อมูลสำหรับรายการช่องทำเครื่องหมายนี้ |
showOtherOption(enabled) | CheckboxItem | ตั้งค่าว่ารายการนั้นมีตัวเลือก "อื่นๆ" หรือไม่ |
เอกสารประกอบโดยละเอียด
clearValidation()
นำการตรวจสอบข้อมูลสำหรับรายการช่องทำเครื่องหมายนี้ออก
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value)
สร้างตัวเลือกใหม่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
value | String | ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม |
รีเทิร์น
Choice
— ตัวเลือกใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createChoice(value, isCorrect)
สร้างตัวเลือกใหม่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
value | String | ค่าของตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม |
isCorrect | Boolean | ตัวเลือกเป็นคำตอบที่ถูกต้องหรือไม่ |
รีเทิร์น
Choice
— ตัวเลือกใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
สร้าง ItemResponse
ใหม่สำหรับรายการช่องทำเครื่องหมายนี้ อาร์กิวเมนต์ responses
คืออาร์เรย์ String[]
ซึ่งมีค่าที่ต้องตรวจสอบ มีข้อยกเว้นหากค่าใดไม่ตรงกับตัวเลือกที่ถูกต้องสำหรับรายการนี้ เว้นแต่ว่าจะกำหนดค่า showOtherOption(enabled)
เป็น true
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
responses | String[] | อาร์เรย์ของคำตอบที่ถูกต้องสำหรับรายการปรนัยนี้ |
รีเทิร์น
ItemResponse
— การตอบกลับของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
สร้างสำเนาของรายการนี้และเพิ่มต่อท้ายแบบฟอร์ม
รีเทิร์น
CheckboxItem
— ซ้ำกับ CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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()
hasOtherOption()
ระบุว่ารายการมีตัวเลือก "อื่นๆ" หรือไม่
รีเทิร์น
Boolean
— true
หากรายการมีตัวเลือก "อื่นๆ" false
หากไม่มี
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addListItem(); item.setTitle('Do you prefer cats or dogs?'); item.setChoiceValues(['Dogs', 'Cats']);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
values | String[] | อาร์เรย์ของค่าตัวเลือก ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 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') ]);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
choices | Choice[] | ตัวเลือกมากมาย |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การขว้าง
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());
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
feedback | QuizFeedback | ความคิดเห็นใหม่ ค่า Null จะล้างความคิดเห็น |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
ตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามไม่ถูกต้อง
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
feedback | QuizFeedback | ความคิดเห็นใหม่ |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในการจัดวาง เช่น ImageItems
, PageBreakItems
และ SectionHeaderItems
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ข้อความช่วยเหลือใหม่ |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
กำหนดจำนวนคะแนนที่รายการให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
points | Integer | จำนวนคะแนนที่รายการคำถามมีมูลค่า |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
enabled | Boolean | ผู้ตอบต้องตอบคำถามนั้นหรือไม่ |
รีเทิร์น
CheckboxItem
— รายการปัจจุบัน (สำหรับการทำเชน)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
title | String | ชื่อหรือข้อความส่วนหัวใหม่ |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
ตั้งค่าการตรวจสอบข้อมูลสำหรับรายการช่องทำเครื่องหมายนี้ การผ่านใน Null หรือการตรวจสอบโดยไม่มีฟังก์ชันที่จำเป็น จะเป็นการนำการตรวจสอบก่อนหน้านี้ออก
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
validation | CheckboxValidation | CheckboxValidation เพื่อใช้กับรายการนี้ |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
ตั้งค่าว่ารายการนั้นมีตัวเลือก "อื่นๆ" หรือไม่ ค่าเริ่มต้นสำหรับ CheckboxItem
หรือ MultipleChoiceItem
ใหม่คือ false
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากรายการมีตัวเลือก "อื่นๆ" หรือ false หากไม่มี |
รีเทิร์น
CheckboxItem
— CheckboxItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms