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