Class ScaleItem

ScaleItem

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

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
createResponse(response)ItemResponseสร้าง ItemResponse ใหม่สำหรับรายการมาตราส่วนนี้
duplicate()ScaleItemสร้างสำเนาของรายการนี้และต่อท้ายแบบฟอร์ม
getGeneralFeedback()QuizFeedback|nullแสดงความคิดเห็นที่แสดงต่อผู้ตอบเมื่อตอบคำถามที่ให้คะแนนได้
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 อยู่นอกขอบเขตที่ตั้งไว้สำหรับรายการ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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|null - ความคิดเห็น (หากมี)

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

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

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
lowerIntegerขอบเขตล่างใหม่
upperIntegerขอบเขตบนใหม่

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

การขว้าง

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

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

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

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

setGeneralFeedback(feedback)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
feedbackQuizFeedbackความคิดเห็นใหม่

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

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

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

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

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

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

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

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

setLabels(lower, upper)

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

พารามิเตอร์

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

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

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

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

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

setPoints(points)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
pointsIntegerจำนวนคะแนนของคำถาม

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

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

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

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

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

ScaleItemScaleItem นี้สำหรับการเชื่อมโยง

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

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

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