Item pertanyaan yang memungkinkan responden memilih satu opsi dari rangkaian bernomor radio
tombol. Item dapat diakses atau dibuat dari Form
. Saat digunakan dalam kuis, 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 bagian akhir formulir. |
getGeneralFeedback() | QuizFeedback | 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. |
getLeftLabel() | String | Mendapatkan label untuk batas bawah skala, jika ada. |
getLowerBound() | Integer | Mendapatkan batas bawah skala. |
getPoints() | Integer | Menampilkan nilai poin dari 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 direpresentasikan 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 menjawab 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 titik nilai 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 |
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 bagian akhir formulir.
Pulang pergi
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 menjawab 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
getLeftLabel()
Mendapatkan label untuk batas bawah skala, jika ada.
Pulang pergi
String
— label untuk 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
getLowerBound()
Mendapatkan batas bawah skala.
Pulang pergi
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 dari item yang dapat dinilai.
Pulang pergi
Integer
— jumlah poin yang bernilai untuk 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.
Pulang pergi
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
).
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()
getUpperBound()
Mendapatkan batas atas timbangan.
Pulang pergi
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.
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
setBounds(lower, upper)
Menetapkan batas bawah dan atas skala. Batas bawah harus 0
atau 1
. Tujuan
batas atas harus antara 3
dan 10
, inklusif. Skala baru 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 terpotong ke bilangan bulat sebelumnya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
lower | Integer | batas bawah baru |
upper | Integer | batas atas baru |
Pulang pergi
ScaleItem
— ScaleItem
ini, untuk perantai
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 menjawab 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 baru |
Pulang pergi
ScaleItem
— ScaleItem
ini, untuk perantai
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
ScaleItem
— ScaleItem
ini, untuk perantai
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 |
Pulang pergi
ScaleItem
— ScaleItem
ini, untuk perantai
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 titik nilai item yang dapat dinilai. Default untuk item baru adalah 0.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
points | Integer | jumlah poin yang bernilai untuk item pertanyaan |
Pulang pergi
ScaleItem
— ScaleItem
ini, untuk perantai
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 atau tidak |
Pulang pergi
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 |
Pulang pergi
ScaleItem
— ScaleItem
ini, untuk perantai
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