Class CheckboxItem

CheckboxItem

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

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
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

---

createResponse(responses)

สร้าง ItemResponse ใหม่สำหรับรายการช่องทําเครื่องหมายนี้ อาร์กิวเมนต์ responses คือString[] อาร์เรย์ที่มีค่าที่ต้องตรวจสอบ ยกเว้นข้อยกเว้นหากค่าใดไม่ตรงกับตัวเลือกที่ถูกต้องสำหรับรายการนี้ เว้นแต่จะมีการตั้งค่า showOtherOption(enabled) เป็น true

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
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()

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

รีเทิร์น

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

---

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
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.
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[]	ตัวเลือกมากมาย

รีเทิร์น

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.
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 จะล้างความคิดเห็น

รีเทิร์น

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

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

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

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

---

setFeedbackForIncorrect(feedback)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setPoints(points)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setValidation(validation)

ตั้งค่าการตรวจสอบข้อมูลสำหรับรายการช่องทําเครื่องหมายนี้ การส่งค่า Null หรือการตรวจสอบโดยไม่เรียกใช้ฟังก์ชันที่ต้องใช้จะนำการตรวจสอบก่อนหน้าออก

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
validation	CheckboxValidation	CheckboxValidation เพื่อใช้กับรายการนี้

รีเทิร์น

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

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

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

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

---

showOtherOption(enabled)

กำหนดว่ารายการจะมีตัวเลือก "อื่นๆ" หรือไม่ ค่าเริ่มต้นของ CheckboxItem หรือ MultipleChoiceItem ใหม่คือ false

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
enabled	Boolean	true หากสินค้ามีตัวเลือก "อื่นๆ" false หากไม่มี

รีเทิร์น

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

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

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

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