Class RatingItem

RatingItem

Item pertanyaan yang memungkinkan responden memberikan rating. Item dapat diakses atau dibuat dari Form. Jika digunakan dalam kuis, item ini akan dinilai.

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

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
createResponse(response)	ItemResponse	Membuat ItemResponse baru untuk item rating ini.
duplicate()	RatingItem	Membuat salinan item ini dan menambahkannya ke akhir formulir.
getGeneralFeedback()	QuizFeedback|null	Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan yang dapat dinilai.
getHelpText()	String	Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
getId()	Integer	Mendapatkan ID unik item.
getIndex()	Integer	Mendapatkan indeks item di antara semua item dalam formulir.
getPoints()	Integer	Menampilkan nilai poin item yang dapat dinilai.
getRatingIcon()	RatingIconType	Mendapatkan ikon yang dipilih untuk rating.
getRatingScaleLevel()	Integer	Mendapatkan tingkat skala rating.
getTitle()	String	Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()	ItemType	Mendapatkan jenis item, yang direpresentasikan sebagai ItemType.
isRequired()	Boolean	Menentukan apakah responden harus menjawab pertanyaan.
setGeneralFeedback(feedback)	RatingItem	Menetapkan masukan yang akan ditampilkan kepada responden saat mereka merespons pertanyaan yang dapat dinilai yang tidak memiliki jawaban benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).
setHelpText(text)	RatingItem	Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setPoints(points)	RatingItem	Menetapkan jumlah poin yang bernilai untuk item yang dapat dinilai.
setRatingIcon(ratingIcon)	RatingItem	Menetapkan ikon rating.
setRatingScaleLevel(ratingScaleLevel)	RatingItem	Menetapkan tingkat skala maksimum rating.
setRequired(enabled)	RatingItem	Menetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)	RatingItem	Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Dokumentasi mendetail

createResponse(response)

Membuat ItemResponse baru untuk item rating ini.

Menampilkan pengecualian skrip jika response yang diberikan kurang dari 1 atau lebih besar dari nilai yang ditampilkan oleh 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);

Parameter

Nama	Jenis	Deskripsi
response	Integer	Jawaban nilai untuk item rating ini.

Pulang pergi

ItemResponse — Respons item.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

duplicate()

Membuat salinan item ini dan menambahkannya ke akhir formulir.

Pulang pergi

RatingItem — duplikat dari RatingItem ini, untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getGeneralFeedback()

Menampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan yang dapat dinilai.

Pulang pergi

QuizFeedback|null — masukan, jika ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getHelpText()

Mendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Pulang pergi

String — teks bantuan atau teks deskripsi item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getId()

Mendapatkan ID unik item.

Pulang pergi

Integer — ID item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getIndex()

Mendapatkan indeks item di antara semua item dalam formulir.

Pulang pergi

Integer — indeks item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPoints()

Menampilkan nilai poin item yang dapat dinilai.

Pulang pergi

Integer — jumlah poin yang diperoleh dari pertanyaan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getRatingIcon()

Mendapatkan ikon yang dipilih untuk rating.

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

Pulang pergi

RatingIconType — Jenis ikon rating.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getRatingScaleLevel()

Mendapatkan tingkat skala rating.

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

Pulang pergi

Integer — Tingkat skala rating.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getTitle()

Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Pulang pergi

String — judul item atau teks header

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getType()

Mendapatkan jenis item, yang direpresentasikan sebagai ItemType.

Pulang pergi

ItemType — jenis item

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

isRequired()

Menentukan apakah responden harus menjawab pertanyaan.

Pulang pergi

Boolean — apakah responden harus menjawab pertanyaan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setGeneralFeedback(feedback)

Menetapkan masukan yang akan ditampilkan kepada responden saat mereka merespons pertanyaan yang dapat dinilai yang tidak memiliki jawaban benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).

Parameter

Nama	Jenis	Deskripsi
feedback	QuizFeedback	masukan baru

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setHelpText(text)

Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).

Parameter

Nama	Jenis	Deskripsi
text	String	teks bantuan baru

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setPoints(points)

Menetapkan jumlah poin yang bernilai untuk item yang dapat dinilai. Nilai default untuk item baru adalah 0.

Parameter

Nama	Jenis	Deskripsi
points	Integer	jumlah poin yang bernilai untuk item pertanyaan

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setRatingIcon(ratingIcon)

Menetapkan ikon rating.

Menampilkan pengecualian skrip jika jenis ikon rating tidak valid.

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

Parameter

Nama	Jenis	Deskripsi
ratingIcon	RatingIconType	Jenis ikon rating.

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan.

Menampilkan

Error — jika jenis ikon rating tidak valid

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setRatingScaleLevel(ratingScaleLevel)

Menetapkan tingkat skala maksimum rating. Tingkat skala maksimum rating harus antara 3 dan 10, inklusif. Rating baru secara default memiliki tingkat skala rating 3.

Menampilkan pengecualian skrip jika nilai yang diberikan berada di luar batas yang diizinkan.

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

Parameter

Nama	Jenis	Deskripsi
ratingScaleLevel	Integer	Tingkat skala rating.

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan.

Menampilkan

Error — jika tingkat skala rating tidak valid

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setRequired(enabled)

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

Nama	Jenis	Deskripsi
enabled	Boolean	apakah responden harus menjawab pertanyaan tersebut

Pulang pergi

RatingItem — item saat ini (untuk merangkai)

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setTitle(title)

Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).

Parameter

Nama	Jenis	Deskripsi
title	String	judul atau teks header baru

Pulang pergi

RatingItem — RatingItem ini, untuk dirangkaikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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