Class ScaleItem

SkalaItem

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
createResponse(response)ItemResponseMembuat ItemResponse baru untuk item skala ini.
duplicate()ScaleItemMembuat salinan item ini dan menambahkannya ke akhir formulir.
getGeneralFeedback()QuizFeedbackMenampilkan 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 timbangan, jika ada.
getLowerBound()IntegerMendapatkan batas bawah timbangan.
getPoints()IntegerMenampilkan nilai poin dari item yang dapat dinilai.
getRightLabel()StringMendapatkan label untuk batas atas timbangan, jika ada.
getTitle()StringMendapatkan judul item (terkadang disebut teks header, untuk SectionHeaderItem).
getType()ItemTypeMendapatkan jenis item, yang direpresentasikan sebagai ItemType.
getUpperBound()IntegerMendapatkan batas atas timbangan.
isRequired()BooleanMenentukan apakah responden harus menjawab pertanyaan atau tidak.
setBounds(lower, upper)ScaleItemMenetapkan batas bawah dan atas timbangan.
setGeneralFeedback(feedback)ScaleItemMenyetel 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)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 timbangan.
setPoints(points)ScaleItemMenetapkan jumlah poin untuk item yang dapat dinilai.
setRequired(enabled)ScaleItemMenetapkan apakah responden harus menjawab pertanyaan.
setTitle(title)ScaleItemMenetapkan 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

NameJenisDeskripsi
responseIntegerjawaban 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()

Mendapatkan jenis item, yang direpresentasikan sebagai ItemType.

Return

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

NameJenisDeskripsi
lowerIntegerbatas bawah baru
upperIntegerbatas 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

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

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

NameJenisDeskripsi
lowerStringlabel baru untuk batas bawah
upperStringlabel 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

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

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

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