Class GridItem

GridItem

รายการคำถามแสดงเป็นตารางกริดของคอลัมน์และแถว ซึ่งให้ผู้ตอบเลือก หนึ่งตัวเลือกต่อหนึ่งแถวจากปุ่มตัวเลือกตามลำดับ คุณสามารถเข้าถึงหรือสร้างรายการได้จาก 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 สำหรับคำถามตารางกริดที่ไม่จำเป็นระบุว่าไม่มีคำตอบในแถวนั้น ส่ง ยกเว้นในกรณีที่ค่าใดๆ ไม่ตรงกับตัวเลือกที่ถูกต้อง

พารามิเตอร์

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