Item pertanyaan yang memungkinkan responden memilih satu opsi dari urutan tombol pilihan
bernomor. Item dapat diakses atau dibuat dari Form
. Saat digunakan dalam kuis, item-item ini akan dinilai.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
createResponse(response) | ItemResponse | Membuat ItemResponse baru untuk item skala ini. |
duplicate() | ScaleItem | Membuat salinan item ini dan menambahkannya ke akhir formulir. |
getGeneralFeedback() | QuizFeedback | Menampilkan masukan yang ditampilkan kepada responden saat mereka menanggapi 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. |
getLeftLabel() | String | Mendapatkan label untuk batas bawah timbangan, jika ada. |
getLowerBound() | Integer | Mendapatkan batas bawah timbangan. |
getPoints() | Integer | Menampilkan nilai poin item yang dapat dinilai. |
getRightLabel() | String | Mendapatkan label untuk batas atas timbangan, jika ada. |
getTitle() | String | Mendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem ). |
getType() | ItemType | Mendapatkan jenis item yang ditampilkan sebagai ItemType . |
getUpperBound() | Integer | Mendapatkan batas atas timbangan. |
isRequired() | Boolean | Menentukan apakah responden harus menjawab pertanyaan. |
setBounds(lower, upper) | ScaleItem | Menetapkan batas bawah dan atas skala. |
setGeneralFeedback(feedback) | ScaleItem | Menetapkan masukan untuk ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai yang tidak memiliki jawaban yang benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual). |
setHelpText(text) | ScaleItem | Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems , PageBreakItems , dan SectionHeaderItems ). |
setLabels(lower, upper) | ScaleItem | Menetapkan label untuk batas bawah dan atas skala. |
setPoints(points) | ScaleItem | Menetapkan jumlah poin yang bernilai untuk item yang dapat dinilai. |
setRequired(enabled) | ScaleItem | Menetapkan apakah responden harus menjawab pertanyaan. |
setTitle(title) | ScaleItem | Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem ). |
Dokumentasi mendetail
createResponse(response)
Membuat ItemResponse
baru untuk item skala ini. Menampilkan pengecualian jika argumen response
berada di luar batas yang ditetapkan untuk item.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
response | Integer | jawaban nilai untuk item skala ini |
Return
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.
Return
ScaleItem
— duplikat dari ScaleItem
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
getGeneralFeedback()
Menampilkan masukan yang ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai.
Return
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
).
Return
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.
Return
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.
Return
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
getLeftLabel()
Mendapatkan label untuk batas bawah timbangan, jika ada.
Return
String
— label untuk batas bawah timbangan
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
getLowerBound()
Mendapatkan batas bawah timbangan.
Return
Integer
— batas bawah skala
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.
Return
Integer
— jumlah poin yang dimiliki sebuah 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
getRightLabel()
Mendapatkan label untuk batas atas timbangan, jika ada.
Return
String
— label untuk batas atas timbangan
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
).
Return
String
— teks judul atau 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()
getUpperBound()
Mendapatkan batas atas timbangan.
Return
Integer
— batas atas timbangan
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.
Return
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
setBounds(lower, upper)
Menetapkan batas bawah dan atas skala. Batas bawah harus 0
atau 1
. Batas
atas harus antara 3
dan 10
, inklusif. Skala baru ditetapkan secara default ke
batas bawah 1
dan batas atas 5
.
Menampilkan pengecualian pembuatan skrip jika nilai yang diberikan berada di luar batas yang diizinkan. Desimal dipotong menjadi bilangan bulat sebelumnya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
lower | Integer | batas bawah yang baru |
upper | Integer | batas atas baru |
Return
ScaleItem
— ScaleItem
ini, untuk perantaian
Menampilkan
Error
— jika batas bawah atau atas 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
setGeneralFeedback(feedback)
Menetapkan masukan untuk ditampilkan kepada responden saat mereka menanggapi pertanyaan yang dapat dinilai yang tidak memiliki jawaban yang benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
feedback | QuizFeedback | masukan yang baru |
Return
ScaleItem
— ScaleItem
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 |
Return
ScaleItem
— ScaleItem
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
setLabels(lower, upper)
Menetapkan label untuk batas bawah dan atas skala.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
lower | String | label baru untuk batas bawah |
upper | String | label baru untuk batas atas |
Return
ScaleItem
— ScaleItem
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 bernilai untuk item yang dapat dinilai. Default untuk item baru adalah 0.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
points | Integer | jumlah poin yang bernilai dari item pertanyaan |
Return
ScaleItem
— ScaleItem
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
setRequired(enabled)
Menetapkan apakah responden harus menjawab pertanyaan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | apakah responden harus menjawab pertanyaan |
Return
ScaleItem
— item saat 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
setTitle(title)
Menetapkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem
).
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
title | String | judul atau teks {i>header<i} baru |
Return
ScaleItem
— ScaleItem
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