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 hasil 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 | Menampilkan masukan yang ditampilkan kepada responden saat mereka merespons 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 diperoleh item yang dapat dinilai. |
setRatingIcon(ratingIcon) | RatingItem | Menetapkan ikon rating. |
setRatingScaleLevel(ratingScaleLevel) | RatingItem | Menetapkan tingkat skala 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 olehgetRatingScaleLevel()
.
// 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);
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 penyambungan
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 merespons pertanyaan yang dapat dinilai.
Pulang pergi
QuizFeedback
— 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 pantas untuk 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 atau teks header 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
getType()
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 perantaian
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 perantaian
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 diperoleh item yang dapat dinilai. Default untuk item baru adalah 0.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
points | Integer | jumlah poin yang pantas untuk item pertanyaan |
Pulang pergi
RatingItem
— RatingItem
ini, untuk perantaian
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 pembuatan 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 perantaian.
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 rating. Tingkat skala rating harus antara 3
dan 10
,
inklusif. Rating baru ditetapkan secara default ke 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 perantaian.
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 |
Pulang pergi
RatingItem
— item saat ini (untuk pembuatan rantai)
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 | teks judul atau header baru |
Pulang pergi
RatingItem
— RatingItem
ini, untuk perantaian
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