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 อยู่นอกขอบเขตที่ตั้งไว้สำหรับรายการ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
response	Integer	คำตอบที่เป็นค่าสำหรับรายการในมาตราส่วนนี้

รีเทิร์น

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

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

พารามิเตอร์

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

รีเทิร์น

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

ส่ง

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

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

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

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

---

setGeneralFeedback(feedback)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setLabels(lower, upper)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setPoints(points)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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