Class MultipleChoiceItem

MultipleChoiceItem

Katılımcının radyo düğmeleri listesinden veya isteğe bağlı bir "diğer" alanından seçim yapmasına olanak tanıyan bir soru öğesidir. Öğelere Form ile erişilebilir veya öğe oluşturulabilir. Bu öğeler, testte kullanıldığında otomatik olarak notlandırılır. 

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

Yöntemler

YöntemDönüş türüKısa açıklama
createChoice(value)ChoiceYeni bir seçim oluşturur.
createChoice(value, isCorrect)ChoiceYeni bir seçim oluşturur.
createChoice(value, navigationItem)ChoiceBelirli bir sayfa sonu öğesine atlayan sayfa gezinme seçeneğiyle yeni bir seçenek oluşturur.
createChoice(value, navigationType)ChoiceSayfada gezinme seçeneği bulunan yeni bir seçenek oluşturur.
createResponse(response)ItemResponseBu çoktan seçmeli öğe için yeni bir ItemResponse oluşturur.
duplicate()MultipleChoiceItemBu öğenin bir kopyasını oluşturur ve bunu formun sonuna ekler.
getChoices()Choice[]Bir öğeyle ilgili tüm seçenekleri alır.
getFeedbackForCorrect()QuizFeedbackKatılımcılara soruya doğru yanıt verdiklerinde gösterilen geri bildirimi döndürür.
getFeedbackForIncorrect()QuizFeedbackKatılımcılara bir soruya yanlış yanıt verdiklerinde gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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ında öğenin dizinini alır.
getPoints()IntegerNot verilebilir bir öğenin puan değerini döndürür.
getTitle()StringÖğenin başlığını alır (SectionHeaderItem durumunda başlık metni de denir).
getType()ItemTypeÖğenin türünü alır (ItemType ile gösterilir).
hasOtherOption()BooleanÖğede "diğer" seçeneğinin olup olmadığını belirler.
isRequired()BooleanKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setChoiceValues(values)MultipleChoiceItemBir dize dizisinden öğe için seçenekleri ayarlar.
setChoices(choices)MultipleChoiceItemBir öğe için seçim dizisi ayarlar.
setFeedbackForCorrect(feedback)MultipleChoiceItemKatılımcılar bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)MultipleChoiceItemSoruya yanlış yanıt verdiklerinde katılımcılara gösterilecek geri bildirimi ayarlar.
setHelpText(text)MultipleChoiceItemÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.
setPoints(points)MultipleChoiceItemNot verilebilir bir öğenin kaç puan değerinde olduğunu belirler.
setRequired(enabled)MultipleChoiceItemKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setTitle(title)MultipleChoiceItemÖğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir).
showOtherOption(enabled)MultipleChoiceItemÖğede "diğer" seçeneği olup olmadığını belirler.

Ayrıntılı belgeler

createChoice(value)

Yeni bir seçim oluşturur.

Parametreler

AdTürAçıklama
valueStringKatılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri

Return

Choice - yeni seçenek

Yetkilendirme

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

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

createChoice(value, isCorrect)

Yeni bir seçim oluşturur.

Parametreler

AdTürAçıklama
valueStringKatılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri
isCorrectBooleanseçimin doğru cevap olup olmadığı

Return

Choice - yeni seçenek

Yetkilendirme

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

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

createChoice(value, navigationItem)

Belirli bir sayfa sonu öğesine atlayan sayfa gezinme seçeneğiyle yeni bir seçenek oluşturur. Bu, navigationType değeri FormApp.PageNavigationType.GO_TO_PAGE olarak ayarlanmış createChoice(value, navigationType) işlevine eşdeğerdir. Sayfada gezinmeyi kullanan seçenekler, sayfada gezinmeyi kullanmayan seçeneklerle aynı öğede birleştirilemez.

Sayfada gezinme, katılımcı ilgili seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği işaretlemişse gerçekleşir. Katılımcı aynı sayfada gezinme talimatlarıyla birden fazla seçenek belirlerse yalnızca son gezinme seçeneğinin etkili olur. Sayfada gezinmenin, bir formun son sayfası üzerinde de hiçbir etkisi yoktur.

Parametreler

AdTürAçıklama
valueStringKatılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri
navigationItemPageBreakItemgidilecek öğe

Return

Choice - yeni seçenek

Yetkilendirme

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

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

createChoice(value, navigationType)

Sayfada gezinme seçeneği bulunan yeni bir seçenek oluşturur. Sayfada gezinmeyi kullanan seçenekler, sayfada gezinmeyi kullanmayan seçeneklerle aynı öğe içinde birleştirilemez.

Sayfada gezinme, katılımcı ilgili seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği işaretlemişse gerçekleşir. Katılımcı aynı sayfada gezinme talimatlarıyla birden fazla seçenek belirlerse yalnızca son gezinme seçeneğinin etkili olur. Sayfada gezinmenin, bir formun son sayfası üzerinde de hiçbir etkisi yoktur.

Parametreler

AdTürAçıklama
valueStringKatılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri
navigationTypePageNavigationTypeseçimin gezinme türü

Return

Choice - yeni seçenek

Yetkilendirme

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

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

createResponse(response)

Bu çoktan seçmeli öğe için yeni bir ItemResponse oluşturur. showOtherOption(enabled), true olarak ayarlanmadığı sürece response bağımsız değişkeni bu öğe için geçerli bir seçenekle eşleşmezse istisna oluşturur.

Parametreler

AdTürAçıklama
responseStringbu çoktan seçmeli öğe için geçerli bir cevap

Return

ItemResponse: Öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bunu formun sonuna ekler.

Return

MultipleChoiceItem — zincirleme bağlantı için bu MultipleChoiceItem öğesinin kopyası

Yetkilendirme

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

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

getChoices()

Bir öğeyle ilgili tüm seçenekleri alır.

Return

Choice[]: seçimler dizisi

Yetkilendirme

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

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

getFeedbackForCorrect()

Katılımcılara soruya doğru yanıt verdiklerinde gösterilen geri bildirimi döndürür.

Return

QuizFeedback - geri bildirim (varsa).

Yetkilendirme

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

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

getFeedbackForIncorrect()

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

Return

QuizFeedback - geri bildirim (varsa).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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 kapsamların 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 kapsamların 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 kapsamların biri 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 değeri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ü alır (ItemType ile gösterilir).

Return

ItemType - öğenin türü

Yetkilendirme

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

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

hasOtherOption()

Öğede "diğer" seçeneğinin olup olmadığını belirler.

Return

Boolean: Öğede "diğer" seçeneği varsa true; yoksa false

Yetkilendirme

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

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

setChoiceValues(values)

Bir dize dizisinden öğe için seçenekleri ayarlar. Belirtilen dizi boşsa bir istisna atar. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametreler

AdTürAçıklama
valuesString[]Katılımcıların formu görüntülerken etiket olarak gördüğü seçim değerleri dizisi

Return

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

Yetkilendirme

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

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

setChoices(choices)

Bir öğe için seçim dizisi ayarlar. Belirtilen dizi boşsa veya null öğesi içeriyorsa istisna atar. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parametreler

AdTürAçıklama
choicesChoice[]bir dizi seçenek

Return

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

Dekoratif yastıklar

Error - Belirtilen dizi null ise, boşsa veya null öğesi içeriyorsa

Yetkilendirme

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

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

setFeedbackForCorrect(feedback)

Katılımcılar bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim. Boş değer, geri bildirimi siler.

Return

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

Yetkilendirme

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

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

setFeedbackForIncorrect(feedback)

Soruya yanlış yanıt verdiklerinde katılımcılara gösterilecek geri bildirimi ayarlar.

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 kaç puan değerinde olduğunu belirler. Yeni öğeler için varsayılan değer 0'dır.

Parametreler

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

Return

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

Yetkilendirme

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

Parametreler

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

Return

MultipleChoiceItem - geçerli öğe (zincirleme için)

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).

Parametreler

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

Return

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

Yetkilendirme

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

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

showOtherOption(enabled)

Öğede "diğer" seçeneği olup olmadığını belirler. Yeni CheckboxItem veya MultipleChoiceItem için varsayılan değer false'dir.

Parametreler

AdTürAçıklama
enabledBooleanÖğede "diğer" seçeneği varsa true; yoksa false

Return

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

Yetkilendirme

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

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