Class MultipleChoiceItem

MultipleChoiceItem

Katılımcının radyo düğmeleri listesinden bir seçenek belirlemesini sağlayan bir soru öğesi veya isteğe bağlı bir "other" girin. Öğelere Form üzerinden erişebilir veya öğe oluşturabilirsiniz. Kullanıldığında bu öğeler 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ç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ğiyle yeni bir seçenek oluşturur.
createChoice(value, navigationType)ChoiceSayfada gezinme seçeneğiyle 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 formun sonuna ekler.
getChoices()Choice[]Bir öğeyle ilgili tüm seçenekleri alır.
getFeedbackForCorrect()QuizFeedbackKatılımcılara bir 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 (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.
getPoints()IntegerNot verilebilir bir öğenin puan değerini döndürü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.
hasOtherOption()BooleanÖğede "other" öğesinin olup olmadığını belirler seçeneğini belirleyin.
isRequired()BooleanKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setChoiceValues(values)MultipleChoiceItemBir dize dizisindeki bir öğeyle ilgili seçimleri ayarlar.
setChoices(choices)MultipleChoiceItemBir öğe için seçim dizisi ayarlar.
setFeedbackForCorrect(feedback)MultipleChoiceItemKatılımcılara bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)MultipleChoiceItemKatılımcılara bir soruya yanlış yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
setHelpText(text)MultipleChoiceItemÖğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).
setPoints(points)MultipleChoiceItemNot verilebilir bir öğenin sahip olduğu puan sayısını ayarlar.
setRequired(enabled)MultipleChoiceItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)MultipleChoiceItemÖğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).
showOtherOption(enabled)MultipleChoiceItemÖğede "other" ifadesinin bulunup bulunmadığını belirler seçeneğini belirleyin.

Ayrıntılı belgeler

createChoice(value)

Yeni bir seçenek 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 kapsamlardan bir 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
valueStringkatılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri
isCorrectBooleanseçimin doğru yanıt olup olmadığı

Return

Choice - yeni seçenek

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

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 ayarlandığı createChoice(value, navigationType) ile eşdeğerdir. Sayfayı kullanan seçenekler gezinme özelliği, sayfada gezinmeyi kullanmayan seçeneklerle aynı öğede birleştirilemez.

Sayfada gezinme, katılımcının ilgili seçeneği içeren sayfayı tamamlamasından sonra gerçekleşir. ve yalnızca katılımcının bu seçeneği belirlemesi gerekir. Katılımcılar tek bir cümleyle değil, yalnızca son gezinme seçeneğinin etkisi vardır. Sayfada gezinmenin, formun son sayfası üzerinde de herhangi 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 kapsamlardan bir 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ğiyle yeni bir seçenek oluşturur. Sayfada gezinmeyi kullanan seçenekler sayfada gezinmeyi kullanmayan seçeneklerle birlikte birleştirir.

Sayfada gezinme, katılımcının ilgili seçeneği içeren sayfayı tamamlamasından sonra gerçekleşir. ve yalnızca katılımcının bu seçeneği belirlemesi gerekir. Katılımcılar tek bir cümleyle değil, yalnızca son gezinme seçeneğinin etkisi vardır. Sayfada gezinmenin, formun son sayfası üzerinde de herhangi 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 kapsamlardan bir 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. Şu durumda bir istisna atar: showOtherOption(enabled), true olarak ayarlanmadığı sürece response bağımsız değişkeni, bu öğe için geçerli bir seçimle eşleşmiyor.

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

MultipleChoiceItem — zincirleme için bu MultipleChoiceItem öğ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

getChoices()

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

Return

Choice[] — bir dizi seçenek

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

getFeedbackForCorrect()

Katılımcılara bir soruya doğru 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

getFeedbackForIncorrect()

Katılımcılara bir soruya yanlış 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

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

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

hasOtherOption()

Öğede "other" öğesinin olup olmadığını belirler seçeneğini belirleyin.

Return

Boolean — Öğede "other" değeri varsa true seçenek; Değilse false

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

setChoiceValues(values)

Bir dize dizisindeki bir öğeyle ilgili seçimleri ayarlar. Verilen diziyse bir istisna atar boştur. 

// 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 etiketler 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 kapsamlardan bir 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. Verilen dizi boşsa veya null öğesi içerir. 

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

Fırlatma

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

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

setFeedbackForCorrect(feedback)

Katılımcılara 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 bildirimi alabilirsiniz. Boş değer, geri bildirimi temizler.

Return

MultipleChoiceItem — bu MultipleChoiceItem, 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

setFeedbackForIncorrect(feedback)

Katılımcılara bir soruya yanlış yanıt verdiklerinde 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 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

MultipleChoiceItem — bu MultipleChoiceItem, 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

MultipleChoiceItem — bu MultipleChoiceItem, 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

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

MultipleChoiceItem — bu MultipleChoiceItem, 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

showOtherOption(enabled)

Öğede "other" ifadesinin bulunup bulunmadığını belirler seçeneğini belirleyin. Yeni bir CheckboxItem veya MultipleChoiceItem false.

Parametreler

AdTürAçıklama
enabledBooleanÖğede "other" ifadesi varsa true seçenek; Değilse false

Return

MultipleChoiceItem — bu MultipleChoiceItem, 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