Class RatingItem

RatingItem

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();

// Create a new rating item.
const ratingItem = form.addRatingItem();

// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);

เมธอด

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

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

createResponse(response)

สร้าง ItemResponse ใหม่สำหรับรายการการจัดประเภทนี้

แสดงข้อยกเว้นสคริปต์หาก response ที่ระบุน้อยกว่า 1 หรือมากกว่าค่าที่ getRatingScaleLevel() แสดง

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and create a new response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

duplicate()

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

รีเทิร์น

RatingItem — รายการ RatingItem รายการนี้ซ้ำกันสำหรับใช้ต่อท้าย

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

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

---

getPoints()

แสดงผลคะแนนของงานที่มีคะแนน

รีเทิร์น

Integer — จํานวนคะแนนของคําถาม

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

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

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

---

getRatingIcon()

รับไอคอนที่เลือกสำหรับการจัดประเภท

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();

รีเทิร์น

RatingIconType — ประเภทไอคอนการให้คะแนน

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

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

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

---

getRatingScaleLevel()

รับระดับสเกลการให้คะแนน

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();

รีเทิร์น

Integer — ระดับสเกลการให้คะแนน

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

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

---

setGeneralFeedback(feedback)

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

พารามิเตอร์

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

รีเทิร์น

RatingItem — RatingItem นี้สําหรับการเชน

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

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

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

---

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

RatingItem — RatingItem นี้สําหรับการเชน

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

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

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

---

setPoints(points)

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

พารามิเตอร์

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

รีเทิร์น

RatingItem — RatingItem นี้สําหรับการเชน

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

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

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

---

setRatingIcon(ratingIcon)

ตั้งค่าไอคอนของการจัดประเภท

แสดงข้อยกเว้นสคริปต์หากประเภทไอคอนการจัดประเภทไม่ถูกต้อง

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
ratingIcon	RatingIconType	ประเภทไอคอนการให้คะแนน

รีเทิร์น

RatingItem — RatingItem สำหรับใช้ต่อ

โยน

Error - หากประเภทไอคอนการให้คะแนนไม่ถูกต้อง

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

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

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

---

setRatingScaleLevel(ratingScaleLevel)

กำหนดระดับสเกลการให้คะแนน ระดับรูปแบบการให้คะแนนต้องอยู่ระหว่าง 3 ถึง 10 เท่านั้น คะแนนใหม่จะเป็นระดับ 3 โดยค่าเริ่มต้น

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

// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
ratingScaleLevel	Integer	ระดับสเกลการให้คะแนน

รีเทิร์น

RatingItem — RatingItem สำหรับใช้ต่อ

โยน

Error — หากระดับสเกลการให้คะแนนไม่ถูกต้อง

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

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

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

---

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

---

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

RatingItem — RatingItem นี้สําหรับการเชน

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

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

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