Class GridItem

GridItem

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

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 สำหรับคำถามแบบตารางกริดที่ไม่ต้องระบุจะตอบกลับแถวนั้นไม่ได้ อาจมีข้อยกเว้นหากค่าใดค่าหนึ่งไม่ตรงกับตัวเลือกที่ถูกต้อง

พารามิเตอร์

ชื่อTypeคำอธิบาย
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)

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

พารามิเตอร์

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

รีเทิร์น

GridItem — สินค้านี้สำหรับการทำเชน

การขว้าง

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

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

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

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

setHelpText(text)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
textStringข้อความช่วยเหลือใหม่

รีเทิร์น

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

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

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

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

setRequired(enabled)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
enabledBooleanผู้ตอบต้องตอบคำถามนั้นหรือไม่

รีเทิร์น

GridItem — รายการปัจจุบัน (สำหรับการทำเชน)

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

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

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

setRows(rows)

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

พารามิเตอร์

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

รีเทิร์น

GridItem — สินค้านี้สำหรับการทำเชน

การขว้าง

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

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

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

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

setTitle(title)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
titleStringชื่อหรือข้อความส่วนหัวใหม่

รีเทิร์น

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

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

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

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

setValidation(validation)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
validationGridValidationa GridValidation เพื่อใช้กับรายการนี้

รีเทิร์น

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

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

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

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