Class MultipleChoiceItem

ÇoktanSeçmeliÖğe

Yanıtlayanın radyo düğmeleri listesinden bir seçenek belirlemesine veya isteğe bağlı "diğer" alanını kullanmasına olanak tanıyan bir soru öğesi. Öğelere Form üzerinden erişilebilir veya öğeler oluşturulabilir. Bu öğeler, testlerde kullanıldığında otomatik olarak puanlanır. 

// Open a form by ID and add a new multiple choice item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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çenek oluşturur.
createChoice(value, isCorrect)ChoiceYeni bir seçenek oluşturur.
createChoice(value, navigationItem)ChoiceBelirli bir sayfa sonu öğesine atlayan sayfa gezinme seçeneği içeren yeni bir tercih oluşturur.
createChoice(value, navigationType)ChoiceSayfa gezinme seçeneği içeren yeni bir seçim 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 formun sonuna ekler.
getChoices()Choice[]Bir öğeyle ilgili tüm seçenekleri alır.
getFeedbackForCorrect()QuizFeedback|nullKatılımcılar bir soruyu doğru yanıtladığında gösterilen geri bildirimi döndürür.
getFeedbackForIncorrect()QuizFeedback|nullKatılımcılar bir soruyu yanlış yanıtladığında 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.
getPoints()IntegerPuan verilebilen bir öğenin puan değerini döndürü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.
hasOtherOption()BooleanÖğede "diğer" seçeneğinin olup olmadığını belirler.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setChoiceValues(values)MultipleChoiceItemBir öğenin seçeneklerini bir dizi dizeden ayarlar.
setChoices(choices)MultipleChoiceItemBir öğe için seçenek dizisi ayarlar.
setFeedbackForCorrect(feedback)MultipleChoiceItemKatılımcılar bir soruyu doğru yanıtladığında gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)MultipleChoiceItemKatılımcılar bir soruyu yanlış yanıtladığında gösterilecek geri bildirimi ayarlar.
setHelpText(text)MultipleChoiceItemÖğ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.
setPoints(points)MultipleChoiceItemNot verilebilen bir öğenin puan değerini ayarlar.
setRequired(enabled)MultipleChoiceItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setTitle(title)MultipleChoiceItemÖğenin başlığını ayarlar (SectionHeaderItem durumunda bazen başlık metni olarak adlandırılır).
showOtherOption(enabled)MultipleChoiceItemÖğenin "diğer" seçeneğine sahip olup olmadığını ayarlar.

Ayrıntılı belgeler

createChoice(value)

Yeni bir seçenek oluşturur.

Parametreler

AdTürAçıklama
valueStringSeçeneğin değeri. Katılımcılar, formu görüntülerken bunu etiket olarak görür.

Return

Choice — yeni seçenek

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

createChoice(value, isCorrect)

Yeni bir seçenek oluşturur.

Parametreler

AdTürAçıklama
valueStringSeçeneğin değeri. Katılımcılar, formu görüntülerken bunu etiket olarak görür.
isCorrectBooleanSeçimin doğru cevap olup olmadığı

Return

Choice — yeni seçenek

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

createChoice(value, navigationItem)

Belirli bir sayfa sonu öğesine atlayan sayfa gezinme seçeneği içeren yeni bir tercih oluşturur. Bu, navigationType değeri FormApp.PageNavigationType.GO_TO_PAGE olarak ayarlanmış createChoice(value, navigationType) ile eşdeğerdir. Sayfa gezinme özelliğini kullanan seçenekler, sayfa gezinme özelliğini kullanmayan seçeneklerle aynı öğede birleştirilemez.

Sayfa gezinme işlemi, katılımcı seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği belirlediyse gerçekleşir. Yanıtlayan, aynı sayfada sayfa gezinme talimatları içeren birden fazla seçenek belirlediyse yalnızca son gezinme seçeneği etkili olur. Sayfada gezinme, formun son sayfasını da etkilemez.

Parametreler

AdTürAçıklama
valueStringSeçeneğin değeri. Katılımcılar, formu görüntülerken bunu etiket olarak görür.
navigationItemPageBreakItemGidilecek öğe

Return

Choice — yeni seçenek

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

createChoice(value, navigationType)

Sayfa gezinme seçeneği içeren yeni bir seçim oluşturur. Sayfa gezinme özelliğini kullanan seçenekler, sayfa gezinme özelliğini kullanmayan seçeneklerle aynı öğede birleştirilemez.

Sayfa gezinme işlemi, katılımcı seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği belirlediyse gerçekleşir. Yanıtlayan, aynı sayfada sayfa gezinme talimatları içeren birden fazla seçenek belirlediyse yalnızca son gezinme seçeneği etkili olur. Sayfada gezinme, formun son sayfasını da etkilemez.

Parametreler

AdTürAçıklama
valueStringSeçeneğin değeri. Katılımcılar, formu görüntülerken bunu etiket olarak görür.
navigationTypePageNavigationTypeSeçimin gezinme türü

Return

Choice — yeni seçenek

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

createResponse(response)

Bu çoktan seçmeli öğe için yeni bir ItemResponse oluşturur. response bağımsız değişkeni, showOtherOption(enabled) true olarak ayarlanmadığı sürece 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 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

MultipleChoiceItem: Zincirleme için bu MultipleChoiceItem öğ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

getChoices()

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

Return

Choice[]: Seçenekler dizisi

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

getFeedbackForCorrect()

Katılımcılar bir soruyu doğru yanıtladığında 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

getFeedbackForIncorrect()

Katılımcılar bir soruyu yanlış yanıtladığında 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

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

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

hasOtherOption()

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

Return

Öğede "diğer" seçeneği varsa Boolean, yoksa truefalse

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

setChoiceValues(values)

Bir öğenin seçeneklerini bir dizi dizeden ayarlar. Belirtilen dizi boşsa istisna oluşturur. 

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

Parametreler

AdTürAçıklama
valuesString[]Yanıtlayanların formu görüntülerken etiket olarak gördüğü seçenek değerleri dizisi

Return

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

setChoices(choices)

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

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

Parametreler

AdTürAçıklama
choicesChoice[]çeşitli seçenekler

Return

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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 kapsamlardan 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 soruyu doğru yanıtladığında gösterilecek geri bildirimi ayarlar. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 bildirimi. Null değeri, geri bildirimi temizler.

Return

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

setFeedbackForIncorrect(feedback)

Katılımcılar bir soruyu yanlış yanıtladığında gösterilecek geri bildirimi ayarlar.

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

MultipleChoiceItem: 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 (SectionHeaderItem durumunda bazen başlık metni olarak adlandırılır).

Parametreler

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

Return

MultipleChoiceItem: Zincirleme için MultipleChoiceItem

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

showOtherOption(enabled)

Öğenin "diğer" seçeneğine sahip olup olmadığını ayarlar. Yeni bir 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: Zincirleme için MultipleChoiceItem

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