Class ScaleItem

ScaleItem

Item pertanyaan yang memungkinkan responden memilih satu opsi dari urutan tombol pilihan bernomor. Item dapat diakses atau dibuat dari Form. Jika digunakan dalam kuis, item ini akan dinilai. 

// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
createResponse(response)ItemResponseMembuat ItemResponse baru untuk item skala ini.
duplicate()ScaleItemMembuat salinan item ini dan menambahkannya ke akhir formulir.
getGeneralFeedback()QuizFeedback|nullMenampilkan masukan yang ditampilkan kepada responden saat mereka menjawab pertanyaan yang dapat dinilai.
getHelpText()StringMendapatkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
getId()IntegerMendapatkan ID unik item.
getIndex()IntegerMendapatkan indeks item di antara semua item dalam formulir.
getLeftLabel()StringMendapatkan label untuk batas bawah skala, jika ada.
getLowerBound()IntegerMendapatkan batas bawah skala.
getPoints()IntegerMenampilkan nilai poin item yang dapat dinilai.
getRightLabel()StringMendapatkan label untuk batas atas skala, jika ada.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, dalam kasus SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
getUpperBound()IntegerMendapatkan batas atas skala.
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan.
setBounds(lower, upper)ScaleItemMenetapkan batas bawah dan atas skala.
setGeneralFeedback(feedback)ScaleItemMenetapkan 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)ScaleItemMenetapkan teks bantuan item (terkadang disebut teks deskripsi untuk item tata letak seperti ImageItems, PageBreakItems, dan SectionHeaderItems).
setLabels(lower, upper)ScaleItemMenetapkan label untuk batas bawah dan atas skala.
setPoints(points)ScaleItemMenetapkan jumlah poin yang bernilai untuk item yang dapat dinilai.
setRequired(enabled)ScaleItemMenetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)ScaleItemMenetapkan 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

NamaJenisDeskripsi
responseIntegerjawaban 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 akhir formulir.

Pulang pergi

ScaleItem — duplikat dari ScaleItem 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

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 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

getRightLabel()

Mendapatkan label untuk batas atas skala, jika ada.

Pulang pergi

String — label untuk batas atas 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

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

getUpperBound()

Mendapatkan batas atas skala.

Pulang pergi

Integer — batas atas 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

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. Batas atas harus antara 3 dan 10, inklusif. Skala baru secara default memiliki batas bawah 1 dan batas atas 5.

Menampilkan pengecualian skrip jika nilai yang diberikan berada di luar batas yang diizinkan. Bilangan desimal dipangkas ke bilangan bulat sebelumnya.

Parameter

NamaJenisDeskripsi
lowerIntegerbatas bawah baru
upperIntegerbatas atas baru

Pulang pergi

ScaleItem — ScaleItem ini, untuk dirangkaikan

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 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

NamaJenisDeskripsi
feedbackQuizFeedbackmasukan baru

Pulang pergi

ScaleItem — ScaleItem 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

NamaJenisDeskripsi
textStringteks bantuan baru

Pulang pergi

ScaleItem — ScaleItem 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

setLabels(lower, upper)

Menetapkan label untuk batas bawah dan atas skala.

Parameter

NamaJenisDeskripsi
lowerStringlabel baru untuk batas bawah
upperStringlabel baru untuk batas atas

Pulang pergi

ScaleItem — ScaleItem 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

NamaJenisDeskripsi
pointsIntegerjumlah poin yang bernilai untuk item pertanyaan

Pulang pergi

ScaleItem — ScaleItem 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

setRequired(enabled)

Menetapkan apakah responden harus menjawab pertanyaan.

Parameter

NamaJenisDeskripsi
enabledBooleanapakah responden harus menjawab pertanyaan tersebut

Pulang pergi

ScaleItem — 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

NamaJenisDeskripsi
titleStringjudul atau teks header baru

Pulang pergi

ScaleItem — ScaleItem 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