Class ScaleItem

ScaleItem

Katılımcının numaralandırılmış bir radyo düğmesi dizisinden bir seçenek belirlemesine olanak tanıyan soru öğesi. Öğelere Form üzerinden erişilebilir veya öğeler oluşturulabilir. Bu öğeler, testlerde kullanıldığında notlandırılır. 

// 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);

Yöntemler

YöntemDönüş türüKısa açıklama
createResponse(response)ItemResponseBu ölçek öğesi için yeni bir ItemResponse oluşturur.
duplicate()ScaleItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getGeneralFeedback()QuizFeedback|nullNot verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) alır.
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizinini alır.
getLeftLabel()StringVarsa ölçeğin alt sınırının etiketini alır.
getLowerBound()IntegerÖlçeğin alt sınırını alır.
getPoints()IntegerPuan verilebilen bir öğenin puan değerini döndürür.
getRightLabel()StringÖlçeğin üst sınırı için varsa etiketi alır.
getTitle()StringÖğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).
getType()ItemTypeÖğenin türünü ItemType olarak alır.
getUpperBound()IntegerÖlçeğin üst sınırını alır.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setBounds(lower, upper)ScaleItemÖlçeğin alt ve üst sınırlarını ayarlar.
setGeneralFeedback(feedback)ScaleItemDoğru veya yanlış yanıtı olmayan (ör. manuel puanlama gerektiren) bir soruyu yanıtlayan katılımcılara gösterilecek geri bildirimi ayarlar.
setHelpText(text)ScaleItemÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
setLabels(lower, upper)ScaleItemÖlçeğin alt ve üst sınırları için etiketler ayarlar.
setPoints(points)ScaleItemNot verilebilen bir öğenin puan değerini ayarlar.
setRequired(enabled)ScaleItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setTitle(title)ScaleItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

Ayrıntılı belgeler

createResponse(response)

Bu ölçek öğesi için yeni bir ItemResponse oluşturur. response bağımsız değişkeni, öğe için belirlenen sınırların dışındaysa istisna oluşturur.

Parametreler

AdTürAçıklama
responseIntegerBu ölçek öğesi için bir değer yanıtı

Return

ItemResponse: Öğenin yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.

Return

ScaleItem: Zincirleme için bu ScaleItem öğesinin kopyası

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGeneralFeedback()

Not verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür.

Return

QuizFeedback|null: Varsa geri bildirim.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) alır.

Return

String — öğenin yardım metni veya açıklama metni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

Öğenin benzersiz tanımlayıcısını alır.

Return

Integer: Öğenin kimliği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

Formdaki tüm öğeler arasında öğenin dizinini alır.

Return

Integer: Öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getLeftLabel()

Varsa ölçeğin alt sınırının etiketini alır.

Return

String: Ölçeğin alt sınırının etiketi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getLowerBound()

Ölçeğin alt sınırını alır.

Return

Integer: Ölçeğin alt sınırı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPoints()

Puan verilebilen bir öğenin puan değerini döndürür.

Return

Integer: Sorunun puan değeri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getRightLabel()

Ölçeğin üst sınırı için varsa etiketi alır.

Return

String: Ölçeğin üst sınırının etiketi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

Öğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).

Return

String: Öğenin başlığı veya başlık metni

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

Öğenin türünü ItemType olarak alır.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getUpperBound()

Ölçeğin üst sınırını alır.

Return

Integer: Ölçeğin üst sınırı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isRequired()

Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.

Return

Boolean: Katılımcının soruyu yanıtlaması gerekip gerekmediği

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setBounds(lower, upper)

Ölçeğin alt ve üst sınırlarını ayarlar. Alt sınır 0 veya 1 olmalıdır. Üst sınır, 3 ile 10 arasında (bu değerler dahil) olmalıdır. Yeni bir ölçek varsayılan olarak 1 alt sınırına ve 5 üst sınırına sahiptir.

Belirtilen değerler izin verilen sınırların dışındaysa bir komut dosyası oluşturma istisnası oluşturur. Ondalık sayılar, kendilerinden önceki tam sayıya kısaltılır.

Parametreler

AdTürAçıklama
lowerIntegeryeni alt sınır
upperIntegeryeni üst sınır

Return

ScaleItem: Zincirleme için bu ScaleItem

Verdiği hatalar

Error: Alt veya üst sınır geçersizse

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGeneralFeedback(feedback)

Doğru veya yanlış yanıtı olmayan (ör. manuel puanlama gerektiren) bir soruyu yanıtlayan katılımcılara gösterilecek geri bildirimi ayarlar.

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

ScaleItem: Zincirleme için bu ScaleItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

ScaleItem: Zincirleme için bu ScaleItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setLabels(lower, upper)

Ölçeğin alt ve üst sınırları için etiketler ayarlar.

Parametreler

AdTürAçıklama
lowerStringAlt sınır için yeni etiket
upperStringÜst sınır için yeni etiket

Return

ScaleItem: Zincirleme için bu ScaleItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setPoints(points)

Not verilebilen bir öğenin puan değerini ayarlar. Yeni öğeler için varsayılan değer 0'dır.

Parametreler

AdTürAçıklama
pointsIntegerbir soru öğesinin puan değeri

Return

ScaleItem: Zincirleme için bu ScaleItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.

Parametreler

AdTürAçıklama
enabledBooleanKatılımcının soruyu yanıtlaması gerekip gerekmediği

Return

ScaleItem: Geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

Öğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

Parametreler

AdTürAçıklama
titleStringYeni başlık veya başlık metni

Return

ScaleItem: Zincirleme için bu ScaleItem

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms