Trang này được dịch bởi Cloud Translation API.

Class 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, các 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ức	Loại dữ liệu trả về	Mô tả ngắn
`createResponse(response)`	`ItemResponse`	Tạo một `ItemResponse` mới cho mục phân loại này.
`duplicate()`	`RatingItem`	Tạo một bản sao của mục này và thêm vào cuối biểu mẫu.
`getGeneralFeedback()`	`QuizFeedback`	Trả về ý kiến phản hồi 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.
`getHelpText()`	`String`	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`).
`getId()`	`Integer`	Lấy giá trị nhận dạng duy nhất của mặt hàng.
`getIndex()`	`Integer`	Lấy chỉ mục của mục trong số tất cả các mục trong biểu mẫu.
`getPoints()`	`Integer`	Trả về giá trị điểm của một mục có thể chấm điểm.
`getRatingIcon()`	`RatingIconType`	Lấy biểu tượng được chọn cho điểm xếp hạng.
`getRatingScaleLevel()`	`Integer`	Lấy cấp thang điểm của điểm xếp hạng.
`getTitle()`	`String`	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 của `SectionHeaderItem`).
`getType()`	`ItemType`	Lấy loại của mục, được biểu thị dưới dạng `ItemType`.
`isRequired()`	`Boolean`	Xác định xem người trả lời có phải trả lời câu hỏi hay không.
`setGeneralFeedback(feedback)`	`RatingItem`	Đặt 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 không có câu trả lời đúng hoặc sai (tức là các 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 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 mức thang điểm của điểm xếp hạng.
`setRequired(enabled)`	`RatingItem`	Đặt xem người trả lời 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 của `SectionHeaderItem`).

Tài liệu chi tiết

`createResponse(response)`

Tạo một ItemResponse mới cho mục phân loại này.

Gửi một ngoại lệ 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 new response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);

Tham số

Tên	Loại	Mô tả
`response`	`Integer`	Câu trả lời có giá trị cho mục xếp hạng này.

Cầu thủ trả bóng

ItemResponse – Phản hồi về mặt hàng.

Ủy quyền

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

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 vào cuối biểu mẫu.

Cầu thủ trả bóng

RatingItem – bản sao của RatingItem này, để tạo chuỗi

Ủy quyền

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

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

`getGeneralFeedback()`

Trả về ý kiến phản hồi 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.

Cầu thủ trả bóng

QuizFeedback – ý 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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ã của mặt hàng

Ủy quyền

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

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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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 của một câu hỏi.

Ủy quyền

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

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 phân loại.

Ủy quyền

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

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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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 của SectionHeaderItem).

Cầu thủ trả bóng

String – tiêu đề hoặc văn bản tiêu đề của mục

Ủy quyền

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

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 của mục

Ủy quyền

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

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

`isRequired()`

Xác định xem người trả lời 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ó 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setGeneralFeedback(feedback)`

Đặt 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 không có câu trả lời đúng hoặc sai (tức là các câu hỏi yêu cầu chấm điểm thủ công).

Tham số

Tên	Loại	Mô tả
`feedback`	`QuizFeedback`	ý kiến phản hồi mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để tạo chuỗi

Ủy quyền

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

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ên	Loại	Mô tả
`text`	`String`	văn bản trợ giúp mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để tạo chuỗi

Ủy quyền

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

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

`setPoints(points)`

Đặt số điểm 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ên	Loại	Mô tả
`points`	`Integer`	số điểm của một mục câu hỏi

Cầu thủ trả bóng

RatingItem – RatingItem này, để tạo chuỗi

Ủy quyền

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

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.

Gửi một ngoại lệ 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ên	Loại	Mô tả
`ratingIcon`	`RatingIconType`	Loại biểu tượng phân loại.

Cầu thủ trả bóng

RatingItem — RatingItem này, để tạo chuỗi.

Gửi

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

Ủy quyền

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

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

`setRatingScaleLevel(ratingScaleLevel)`

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

Gửi một ngoại lệ 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ên	Loại	Mô tả
`ratingScaleLevel`	`Integer`	Cấp thang điểm xếp hạng.

Cầu thủ trả bóng

RatingItem — RatingItem này, để tạo 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:

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

`setRequired(enabled)`

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

Tham số

Tên	Loại	Mô tả
`enabled`	`Boolean`	liệu người trả lời 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 (để tạo chuỗi)

Ủy quyền

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

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 của SectionHeaderItem).

Tham số

Tên	Loại	Mô tả
`title`	`String`	tiêu đề hoặc văn bản tiêu đề mới

Cầu thủ trả bóng

RatingItem – RatingItem này, để tạo chuỗi

Ủy quyền

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

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