รายการคำถามที่ให้ผู้ตอบเลือกได้ 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 | คำอธิบาย |
---|---|---|
response | Integer | คำตอบของค่าสำหรับรายการการปรับขนาดนี้ |
รีเทิร์น
ItemResponse
— การตอบกลับของรายการ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
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()
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 | คำอธิบาย |
---|---|---|
lower | Integer | ขอบเขตล่างใหม่ |
upper | Integer | ขอบเขตบนใหม่ |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การขว้าง
Error
— หากขอบเขตล่างหรือบนไม่ถูกต้อง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
ตั้งค่าความคิดเห็นที่จะแสดงต่อผู้ตอบเมื่อตอบคำถามแบบให้คะแนนได้ที่ไม่มีคำตอบที่ถูกต้องหรือไม่ถูกต้อง (เช่น คำถามที่ต้องมีการให้คะแนนด้วยตนเอง)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
feedback | QuizFeedback | ความคิดเห็นใหม่ |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
ตั้งค่าข้อความช่วยเหลือของรายการ (บางครั้งเรียกว่าข้อความอธิบายสำหรับรายการในการจัดวาง เช่น ImageItems
, PageBreakItems
และ SectionHeaderItems
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ข้อความช่วยเหลือใหม่ |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLabels(lower, upper)
ตั้งค่าป้ายกำกับสำหรับขอบเขตล่างและบนของสเกล
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
lower | String | ป้ายกำกับใหม่สำหรับขอบเขตล่าง |
upper | String | ป้ายกำกับใหม่สำหรับขอบเขตบน |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
กำหนดจำนวนคะแนนที่รายการให้คะแนนได้ ค่าเริ่มต้นสำหรับรายการใหม่คือ 0
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
points | Integer | จำนวนคะแนนที่รายการคำถามมีมูลค่า |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
ตั้งค่าว่าผู้ตอบต้องตอบคำถามหรือไม่
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
enabled | Boolean | ผู้ตอบต้องตอบคำถามนั้นหรือไม่ |
รีเทิร์น
ScaleItem
— รายการปัจจุบัน (สำหรับการทำเชน)
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
ตั้งชื่อรายการ (บางครั้งเรียกว่าข้อความส่วนหัว ในกรณีของ SectionHeaderItem
)
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
title | String | ชื่อหรือข้อความส่วนหัวใหม่ |
รีเทิร์น
ScaleItem
— ScaleItem
นี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms