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

พารามิเตอร์

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

รีเทิร์น

RatingItem — RatingItem นี้สําหรับการต่อเชื่อม

โยน

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