Class GridItem

ตารางกริดรายการ

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

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

เมธอด

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

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

clearValidation()

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

รีเทิร์น

GridItem — รายการนี้สําหรับการต่อเชื่อม

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

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

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

createResponse(responses)

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

พารามิเตอร์

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

รีเทิร์น

ItemResponse — การตอบกลับรายการ

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

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

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

duplicate()

สร้างสําเนาของรายการนี้และเพิ่มไว้ที่ท้ายแบบฟอร์ม

รีเทิร์น

GridItem — รายการ GridItem รายการนี้ซ้ำกันสำหรับใช้ต่อท้าย

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

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

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

พารามิเตอร์

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

รีเทิร์น

GridItem — รายการนี้สําหรับการต่อเชื่อม

โยน

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

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

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

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

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setRows(rows)

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

พารามิเตอร์

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

รีเทิร์น

GridItem — รายการนี้สําหรับการต่อเชื่อม

โยน

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

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setValidation(validation)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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