Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
    .setRows(['New York', 'San Francisco', 'London'])
    .setColumns(['2014', '2015', '2016', '2017']);

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
clearValidation()	CheckboxGridItem	นำการตรวจสอบข้อมูลสำหรับรายการตารางกริดนี้ออก
createResponse(responses)	ItemResponse	สร้าง ItemResponse ใหม่สำหรับรายการตารางช่องทำเครื่องหมายนี้
duplicate()	CheckboxGridItem	สร้างสำเนาของรายการนี้และต่อท้ายแบบฟอร์ม
getColumns()	String[]	รับค่าสำหรับทุกคอลัมน์ในตารางกริด
getHelpText()	String	รับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความคำอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
getId()	Integer	รับตัวระบุที่ไม่ซ้ำกันของรายการ
getIndex()	Integer	รับดัชนีของรายการในบรรดารายการทั้งหมดในแบบฟอร์ม
getRows()	String[]	รับค่าสำหรับทุกแถวในตารางกริด
getTitle()	String	รับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัวในกรณีของ SectionHeaderItem)
getType()	ItemType	รับประเภทของรายการ ซึ่งแสดงเป็น ItemType
isRequired()	Boolean	กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setColumns(columns)	CheckboxGridItem	ตั้งค่าคอลัมน์ของตารางกริดตามอาร์เรย์ของค่า
setHelpText(text)	CheckboxGridItem	ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
setRequired(enabled)	CheckboxGridItem	กำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setRows(rows)	CheckboxGridItem	ตั้งค่าแถวของตารางกริดตามอาร์เรย์ของค่า
setTitle(title)	CheckboxGridItem	ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)
setValidation(validation)	CheckboxGridItem	ตั้งค่าการตรวจสอบข้อมูลสำหรับรายการตารางช่องทำเครื่องหมายนี้

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

clearValidation()

นำการตรวจสอบข้อมูลสำหรับรายการตารางกริดนี้ออก

รีเทิร์น

CheckboxGridItem — รายการนี้สำหรับการเชื่อมโยง

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

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

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

---

createResponse(responses)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
responses	String[][]	อาร์เรย์ของอาร์เรย์ของคำตอบที่ถูกต้องสำหรับรายการตารางคำถามแบบช่องทำเครื่องหมายนี้

รีเทิร์น

ItemResponse - คำตอบของรายการ

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

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

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

---

duplicate()

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

รีเทิร์น

CheckboxGridItem - สำเนาของ CheckboxGridItem นี้สำหรับการเชื่อมโยง

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

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

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

---

getColumns()

รับค่าสำหรับทุกคอลัมน์ในตารางกริด

รีเทิร์น

String[] - อาร์เรย์ของค่าคอลัมน์ ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม

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

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

---

getRows()

รับค่าสำหรับทุกแถวในตารางกริด

รีเทิร์น

String[] — อาร์เรย์ของค่าแถว ซึ่งผู้ตอบจะเห็นเป็นป้ายกำกับเมื่อดูแบบฟอร์ม

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

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

---

setColumns(columns)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — รายการนี้สำหรับการเชื่อมโยง

ส่ง

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

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

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

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

---

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สำหรับการเชื่อมโยง

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

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

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

---

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setRows(rows)

ตั้งค่าแถวของตารางกริดตามอาร์เรย์ของค่า แสดงข้อยกเว้นหากอาร์เรย์ที่ระบุ ว่างเปล่า

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — รายการนี้สำหรับการเชื่อมโยง

ส่ง

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

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

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

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

---

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สำหรับการเชื่อมโยง

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

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

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

---

setValidation(validation)

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

พารามิเตอร์

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

รีเทิร์น

CheckboxGridItem — CheckboxGridItem นี้สำหรับการเชื่อมโยง

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

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

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