Class 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 response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

พารามิเตอร์

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

รีเทิร์น

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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setHelpText(text)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setPoints(points)

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

พารามิเตอร์

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

รีเทิร์น

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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
ratingIconRatingIconTypeประเภทไอคอนการจัดประเภท

รีเทิร์น

RatingItem — This RatingItem, for chaining.

การขว้าง

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);

พารามิเตอร์

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

รีเทิร์น

RatingItem — This RatingItem, for chaining.

การขว้าง

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

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

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

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

setRequired(enabled)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTitle(title)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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