Class RatingItem

RatingItem

Một mục câu hỏi cho phép người trả lời đưa ra điểm xếp hạng. Bạn có thể truy cập hoặc tạo các mục từ Form. Khi được dùng trong bài kiểm tra, những mục này sẽ được chấm điểm. 

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

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
createResponse(response)ItemResponseTạo một ItemResponse mới cho mục xếp hạng này.
duplicate()RatingItemTạo một bản sao của mục này và thêm bản sao đó vào cuối biểu mẫu.
getGeneralFeedback()QuizFeedback|nullTrả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời một câu hỏi có thể chấm điểm.
getHelpText()StringLấy văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItems và SectionHeaderItems).
getId()IntegerLấy giá trị nhận dạng duy nhất của mặt hàng.
getIndex()IntegerLấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
getPoints()IntegerTrả về giá trị điểm của một mục có thể chấm điểm.
getRatingIcon()RatingIconTypeLấy biểu tượng được chọn cho điểm xếp hạng.
getRatingScaleLevel()IntegerLấy cấp độ thang điểm của điểm xếp hạng.
getTitle()StringLấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem).
getType()ItemTypeLấy loại của mục, được biểu thị dưới dạng ItemType.
isRequired()BooleanXác định xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.
setGeneralFeedback(feedback)RatingItemĐặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời một câu hỏi có thể chấm điểm nhưng không có câu trả lời đúng hoặc sai (tức là những câu hỏi yêu cầu chấm điểm thủ công).
setHelpText(text)RatingItemĐặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItems và SectionHeaderItems).
setPoints(points)RatingItemĐặt số điểm tương ứng cho một mục có thể chấm điểm.
setRatingIcon(ratingIcon)RatingItemĐặt biểu tượng của mức phân loại.
setRatingScaleLevel(ratingScaleLevel)RatingItemĐặt cấp độ thang điểm tối đa của điểm xếp hạng.
setRequired(enabled)RatingItemĐặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.
setTitle(title)RatingItemĐặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem).

Tài liệu chi tiết

createResponse(response)

Tạo một ItemResponse mới cho mục xếp hạng này.

Gây ra một ngoại lệ về tập lệnh nếu response được cung cấp nhỏ hơn 1 hoặc lớn hơn giá trị do getRatingScaleLevel() trả về. 

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

Tham số

TênLoạiMô tả
responseIntegerCâu trả lời có giá trị cho mục đánh giá này.

Cầu thủ trả bóng

ItemResponse – Phản hồi của mục.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

duplicate()

Tạo một bản sao của mục này và thêm bản sao đó vào cuối biểu mẫu.

Cầu thủ trả bóng

RatingItem – bản sao của RatingItem này, để liên kết

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getGeneralFeedback()

Trả về ý kiến phản hồi mà người trả lời nhìn thấy khi họ trả lời một câu hỏi có thể chấm điểm.

Cầu thủ trả bóng

QuizFeedback|null – ý kiến phản hồi (nếu có).

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getHelpText()

Lấy văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItems và SectionHeaderItems).

Cầu thủ trả bóng

String – văn bản trợ giúp hoặc văn bản mô tả của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getId()

Lấy giá trị nhận dạng duy nhất của mặt hàng.

Cầu thủ trả bóng

Integer – mã nhận dạng của mặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getIndex()

Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.

Cầu thủ trả bóng

Integer – chỉ mục của mục

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getPoints()

Trả về giá trị điểm của một mục có thể chấm điểm.

Cầu thủ trả bóng

Integer – số điểm tương ứng với một câu hỏi.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getRatingIcon()

Lấy biểu tượng được chọn cho điểm xếp hạng. 

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

Cầu thủ trả bóng

RatingIconType – Loại biểu tượng điểm xếp hạng.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getRatingScaleLevel()

Lấy cấp độ thang điểm của điểm xếp hạng. 

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

Cầu thủ trả bóng

Integer – Cấp thang điểm xếp hạng.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getTitle()

Lấy tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem).

Cầu thủ trả bóng

String – tiêu đề hoặc văn bản tiêu đề của mặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getType()

Lấy loại của mục, được biểu thị dưới dạng ItemType.

Cầu thủ trả bóng

ItemType – loại mặt hàng

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

isRequired()

Xác định xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.

Cầu thủ trả bóng

Boolean – liệu người trả lời có bắt buộc phải trả lời câu hỏi hay không

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setGeneralFeedback(feedback)

Đặt thông tin phản hồi sẽ hiển thị cho người trả lời khi họ trả lời một câu hỏi có thể chấm điểm nhưng không có câu trả lời đúng hoặc sai (tức là những câu hỏi yêu cầu chấm điểm thủ công).

Tham số

TênLoạiMô tả
feedbackQuizFeedbacký kiến phản hồi mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setHelpText(text)

Đặt văn bản trợ giúp của mục (đôi khi được gọi là văn bản mô tả cho các mục bố cục như ImageItems, PageBreakItems và SectionHeaderItems).

Tham số

TênLoạiMô tả
textStringvăn bản trợ giúp mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setPoints(points)

Đặt số điểm tương ứng cho một mục có thể chấm điểm. Giá trị mặc định cho các mục mới là 0.

Tham số

TênLoạiMô tả
pointsIntegersố điểm tương ứng với một câu hỏi

Cầu thủ trả bóng

RatingItem – RatingItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setRatingIcon(ratingIcon)

Đặt biểu tượng của mức phân loại.

Đưa ra một trường hợp ngoại lệ về tập lệnh nếu loại biểu tượng phân loại không hợp lệ. 

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

Tham số

TênLoạiMô tả
ratingIconRatingIconTypeLoại biểu tượng điểm xếp hạng.

Cầu thủ trả bóng

RatingItem – RatingItem này dùng để xâu chuỗi.

Gửi

Error – nếu loại biểu tượng xếp hạng không hợp lệ

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setRatingScaleLevel(ratingScaleLevel)

Đặt cấp độ thang điểm tối đa của điểm xếp hạng. Mức thang điểm tối đa của điểm xếp hạng phải nằm trong khoảng từ 3 đến 10. Điểm xếp hạng mới mặc định là 3.

Gửi một ngoại lệ về tập lệnh nếu các giá trị đã cho nằm ngoài giới hạn cho phép. 

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

Tham số

TênLoạiMô tả
ratingScaleLevelIntegerCấp thang điểm xếp hạng.

Cầu thủ trả bóng

RatingItem – RatingItem này dùng để xâu chuỗi.

Gửi

Error – nếu mức thang điểm xếp hạng không hợp lệ

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setRequired(enabled)

Đặt xem người trả lời có bắt buộc phải trả lời câu hỏi hay không.

Tham số

TênLoạiMô tả
enabledBooleanngười trả lời có bắt buộc phải trả lời câu hỏi hay không

Cầu thủ trả bóng

RatingItem – mục hiện tại (để liên kết)

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setTitle(title)

Đặt tiêu đề của mục (đôi khi được gọi là văn bản tiêu đề, trong trường hợp SectionHeaderItem).

Tham số

TênLoạiMô tả
titleStringtiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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