Class ScaleItem

ScaleItem

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

// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
    .setBounds(1, 10);

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
createResponse(response)ItemResponseสร้าง ItemResponse ใหม่สำหรับรายการการปรับขนาดนี้
duplicate()ScaleItemสร้างสำเนาของรายการนี้และเพิ่มต่อท้ายแบบฟอร์ม
getGeneralFeedback()QuizFeedbackแสดงผลความคิดเห็นที่จะปรากฏต่อผู้ตอบเมื่อตอบคำถามแบบให้คะแนนได้
getHelpText()Stringรับข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในเลย์เอาต์ เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
getId()Integerรับตัวระบุที่ไม่ซ้ำกันของสินค้า
getIndex()Integerรับดัชนีของรายการจากรายการทั้งหมดในแบบฟอร์ม
getLeftLabel()Stringรับป้ายกำกับสำหรับขอบเขตล่างของสเกล หากมี
getLowerBound()Integerรับขอบเขตล่างของสเกล
getPoints()Integerแสดงผลค่าคะแนนของรายการที่ให้คะแนนได้
getRightLabel()Stringรับป้ายกำกับสำหรับขอบเขตบนของสเกล หากมี
getTitle()Stringรับชื่อของรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)
getType()ItemTypeรับประเภทของรายการ ซึ่งแสดงเป็น ItemType
getUpperBound()Integerรับขอบเขตบนของสเกล
isRequired()Booleanกำหนดว่าผู้ตอบต้องตอบคำถามหรือไม่
setBounds(lower, upper)ScaleItemตั้งค่าขอบเขตล่างและบนของสเกล
setGeneralFeedback(feedback)ScaleItemตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามแบบให้คะแนนได้ที่ไม่มีคำตอบที่ถูกต้องหรือไม่ถูกต้อง (เช่น คำถามที่ต้องมีการให้คะแนนด้วยตนเอง)
setHelpText(text)ScaleItemตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในการจัดวาง เช่น ImageItems, PageBreakItems และ SectionHeaderItems)
setLabels(lower, upper)ScaleItemตั้งค่าป้ายกำกับสำหรับขอบเขตล่างและบนของสเกล
setPoints(points)ScaleItemกำหนดจำนวนคะแนนที่รายการให้คะแนนได้
setRequired(enabled)ScaleItemตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
setTitle(title)ScaleItemตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem)

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

createResponse(response)

สร้าง ItemResponse ใหม่สำหรับรายการการปรับขนาดนี้ แสดงผลข้อยกเว้นหากอาร์กิวเมนต์ response อยู่นอกขอบเขตที่กำหนดไว้สำหรับรายการ

พารามิเตอร์

ชื่อTypeคำอธิบาย
responseIntegerคำตอบของค่าสำหรับรายการการปรับขนาดนี้

รีเทิร์น

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

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

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

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

duplicate()

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

รีเทิร์น

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

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

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

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

getGeneralFeedback()

แสดงผลความคิดเห็นที่จะปรากฏต่อผู้ตอบเมื่อตอบคำถามแบบให้คะแนนได้

รีเทิร์น

QuizFeedback — ความคิดเห็น (หากมี)

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

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

getLeftLabel()

รับป้ายกำกับสำหรับขอบเขตล่างของสเกล หากมี

รีเทิร์น

String — ป้ายกำกับสำหรับขอบเขตล่างของมาตราส่วน

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

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

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

getLowerBound()

รับขอบเขตล่างของสเกล

รีเทิร์น

Integer — ขอบเขตล่างของมาตราส่วน

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

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

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

getPoints()

แสดงผลค่าคะแนนของรายการที่ให้คะแนนได้

รีเทิร์น

Integer — จำนวนคะแนนที่คำถามมีค่า

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

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

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

getRightLabel()

รับป้ายกำกับสำหรับขอบเขตบนของสเกล หากมี

รีเทิร์น

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

getUpperBound()

รับขอบเขตบนของสเกล

รีเทิร์น

Integer — ขอบเขตบนของมาตราส่วน

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

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

setBounds(lower, upper)

ตั้งค่าขอบเขตล่างและบนของสเกล ขอบเขตล่างต้องเป็น 0 หรือ 1 ขอบเขตบนต้องอยู่ระหว่าง 3 และ 10 เท่านั้น สเกลใหม่จะมีค่าเริ่มต้นเป็นขอบเขตล่างของ 1 และขอบเขตบนเป็น 5

แสดงข้อยกเว้นของสคริปต์หากค่าที่ระบุอยู่นอกขีดจำกัดที่อนุญาต ทศนิยมจะตัดทศนิยมให้เป็นจำนวนเต็มข้างหน้า

พารามิเตอร์

ชื่อTypeคำอธิบาย
lowerIntegerขอบเขตล่างใหม่
upperIntegerขอบเขตบนใหม่

รีเทิร์น

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

การขว้าง

Error — หากขอบเขตล่างหรือบนไม่ถูกต้อง

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

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

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

setGeneralFeedback(feedback)

ตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามแบบให้คะแนนได้ที่ไม่มีคำตอบที่ถูกต้องหรือไม่ถูกต้อง (เช่น คำถามที่ต้องมีการให้คะแนนด้วยตนเอง)

พารามิเตอร์

ชื่อTypeคำอธิบาย
feedbackQuizFeedbackความคิดเห็นใหม่

รีเทิร์น

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

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

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

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

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setLabels(lower, upper)

ตั้งค่าป้ายกำกับสำหรับขอบเขตล่างและบนของสเกล

พารามิเตอร์

ชื่อTypeคำอธิบาย
lowerStringป้ายกำกับใหม่สำหรับขอบเขตล่าง
upperStringป้ายกำกับใหม่สำหรับขอบเขตบน

รีเทิร์น

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

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

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

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

setPoints(points)

กำหนดจำนวนคะแนนที่รายการให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0

พารามิเตอร์

ชื่อTypeคำอธิบาย
pointsIntegerจำนวนคะแนนที่รายการคำถามมีมูลค่า

รีเทิร์น

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

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

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

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

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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