Class ScaleItem

ScaleItem

Katılımcının numaralandırılmış bir radyo sırası arasından bir seçenek belirlemesine olanak tanıyan bir soru öğesi düğmelerini kullanın. Öğelere Form üzerinden erişebilir veya öğe oluşturabilirsiniz. Bu öğeler bir testte kullanıldığında notlandırıldı.

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

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()QuizFeedbackKatılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini alır (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır).
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasından öğenin dizinini alır.
getLeftLabel()StringVarsa ölçeğin alt sınırı için etiket alır.
getLowerBound()IntegerÖlçeğin alt sınırını alır.
getPoints()IntegerNot verilebilir bir öğenin puan değerini döndürür.
getRightLabel()StringVarsa ölçeğin üst sınırına ilişkin etiketi alır.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem olması halinde bazen üstbilgi metni olarak da adlandırılır).
getType()ItemTypeÖğenin ItemType ile gösterilen türünü alır.
getUpperBound()IntegerÖlçeğin üst sınırını alır.
isRequired()BooleanKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setBounds(lower, upper)ScaleItemÖlçeğin alt ve üst sınırlarını ayarlar.
setGeneralFeedback(feedback)ScaleItemKatılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilecek geri bildirimi belirler. (ör. manuel notlandırma gerektiren sorular) doğru veya yanlış bir yanıtı olmayanlar
setHelpText(text)ScaleItemÖğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).
setLabels(lower, upper)ScaleItemölçeğin alt ve üst sınırları için etiketler ayarlar.
setPoints(points)ScaleItemNot verilebilir bir öğenin sahip olduğu puan sayısını ayarlar.
setRequired(enabled)ScaleItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)ScaleItemÖğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da 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 ayarlanan sınırların dışındaysa bir istisna atar.

Parametreler

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

Return

ItemResponse - öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getGeneralFeedback()

Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilen geri bildirimi döndürür.

Return

QuizFeedback — varsa geri bildirim.

Yetkilendirme

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

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

getHelpText()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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ından öğenin dizinini alır.

Return

Integer — öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı için etiket alır.

Return

String — ölçeğin alt sınırı etiketi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getPoints()

Not verilebilir bir öğenin puan değerini döndürür.

Return

Integer: Bir sorunun puan değeri.

Yetkilendirme

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

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

getRightLabel()

Varsa ölçeğin üst sınırına ilişkin etiketi alır.

Return

String — ölçeğin üst sınırı etiketi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (SectionHeaderItem olması halinde bazen üstbilgi metni olarak da 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getType()

Öğenin ItemType ile gösterilen türünü alır.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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 cevaplaması 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 bir 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. İlgili içeriği oluşturmak için kullanılan üst sınır, 3 ile 10 arasında (bu değerler dahil) olmalıdır. Yeni ölçek varsayılan olarak alt sınırı 1 ve üst sınırı 5.

Verilen değerler izin verilen sınırların dışındaysa komut dosyası istisnası hatası atar. Ondalık öncesindeki tam sayıya kısaltılır.

Parametreler

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

Return

ScaleItem — bu ScaleItem, zincirleme bağlantı için

Fırlatma

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

Yetkilendirme

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

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

setGeneralFeedback(feedback)

Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilecek geri bildirimi belirler. (ör. manuel notlandırma gerektiren sorular) doğru veya yanlış bir yanıtı olmayanlar

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

ScaleItem — bu ScaleItem, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

ScaleItem — bu ScaleItem, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 — bu ScaleItem, zincirleme bağlantı için

Yetkilendirme

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

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

setPoints(points)

Not verilebilir bir öğenin sahip olduğu puan sayısını ayarlar. Yeni öğeler için varsayılan değer 0'dır.

Parametreler

AdTürAçıklama
pointsIntegerbir soru öğesinin sahip olduğu puan sayısı

Return

ScaleItem — bu ScaleItem, zincirleme bağlantı için

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı gerekip gerekmediğini belirler.

Parametreler

AdTürAçıklama
enabledBooleankatılımcının soruyu cevaplaması gerekip gerekmediğini

Return

ScaleItem — geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).

Parametreler

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

Return

ScaleItem — bu ScaleItem, zincirleme bağlantı için

Yetkilendirme

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

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