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 ini
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 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 timbangan, jika ada. |
getLowerBound() | Integer | Mendapatkan batas bawah timbangan. |
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, untuk SectionHeaderItem ). |
getType() | ItemType | Mendapatkan jenis item, yang direpresentasikan sebagai ItemType . |
getUpperBound() | Integer | Mendapatkan batas atas timbangan. |
isRequired() | Boolean | Menentukan apakah responden harus menjawab pertanyaan atau tidak. |
setBounds(lower, upper) | ScaleItem | Menetapkan batas bawah dan atas timbangan. |
setGeneralFeedback(feedback) | ScaleItem | Menyetel masukan untuk 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) | 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 timbangan. |
setPoints(points) | ScaleItem | Menetapkan jumlah poin untuk item yang dapat dinilai. |
setRequired(enabled) | ScaleItem | Menetapkan apakah responden harus menjawab pertanyaan. |
setTitle(title) | ScaleItem | Menetapkan judul item (terkadang disebut teks header, untuk SectionHeaderItem ). |
Dokumentasi mendetail
createResponse(response)
Membuat ItemResponse
baru untuk item skala ini. Melempar pengecualian jika argumen response
berada di luar batas yang ditetapkan untuk item.
Parameter
Name | 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 menjawab 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 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
getPoints()
Menampilkan nilai poin dari item yang dapat dinilai.
Return
Integer
— jumlah poin nilai 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, untuk SectionHeaderItem
).
Return
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.
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 atau tidak.
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 timbangan. 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 skrip jika nilai yang diberikan berada di luar batas yang diizinkan. Desimal dipangkas ke bilangan bulat sebelumnya.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
lower | Integer | batas bawah baru |
upper | Integer | batas atas baru |
Return
ScaleItem
— ini ScaleItem
, untuk rantai
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)
Menyetel masukan untuk ditampilkan kepada responden saat mereka merespons pertanyaan yang dapat dinilai yang tidak memiliki jawaban benar atau salah (yaitu pertanyaan yang memerlukan penilaian manual).
Parameter
Name | Jenis | Deskripsi |
---|---|---|
feedback | QuizFeedback | masukan baru |
Return
ScaleItem
— ini ScaleItem
, untuk 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
setHelpText(text)
Menetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems
, PageBreakItems
, dan SectionHeaderItems
).
Parameter
Name | Jenis | Deskripsi |
---|---|---|
text | String | teks bantuan baru |
Return
ScaleItem
— ini ScaleItem
, untuk 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
setLabels(lower, upper)
Menetapkan label untuk batas bawah dan atas timbangan.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
lower | String | label baru untuk batas bawah |
upper | String | label baru untuk batas atas |
Return
ScaleItem
— ini ScaleItem
, untuk 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
setPoints(points)
Menetapkan jumlah poin untuk item yang dapat dinilai. Default untuk item baru adalah 0.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
points | Integer | jumlah poin nilai item pertanyaan |
Return
ScaleItem
— ini ScaleItem
, untuk 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
setRequired(enabled)
Menetapkan apakah responden harus menjawab pertanyaan.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
enabled | Boolean | apakah responden harus menjawab pertanyaan |
Return
ScaleItem
— item saat ini (untuk 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, untuk SectionHeaderItem
).
Parameter
Name | Jenis | Deskripsi |
---|---|---|
title | String | judul atau teks header baru |
Return
ScaleItem
— ini ScaleItem
, untuk 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