Class MultipleChoiceItem

ÇoktanSeçmeliÖğe

Katılımcıya radyo düğmeleri listesinden veya isteğe bağlı bir "diğer" alanından bir seçim yapmasına olanak tanıyan soru öğesi. Öğelere Form'ten erişilebilir veya bu klasörden öğe oluşturulabilir. Bu öğeler, testlerde otomatik olarak notlandırılı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çim oluşturur.
createChoice(value, isCorrect)ChoiceYeni bir seçim oluşturur.
createChoice(value, navigationItem)ChoiceBelirli bir sayfa sonu öğesine atlayan bir sayfa gezinme seçeneğiyle yeni bir seçim oluşturur.
createChoice(value, navigationType)ChoiceSayfa gezinme seçeneğiyle 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()QuizFeedbackKatılımcılar bir soruyu doğru yanıtladığında gösterilen geri bildirimi döndürür.
getFeedbackForIncorrect()QuizFeedbackKatılımcılar bir soruyu yanlış yanıtladığında gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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 dizin numarasını alır.
getPoints()IntegerNot verilebilir bir öğenin puan değerini döndürür.
getTitle()StringÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.
getType()ItemTypeÖğenin türünü ItemType olarak temsil eder.
hasOtherOption()BooleanÖğenin "diğer" seçeneği olup olmadığını belirler.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setChoiceValues(values)MultipleChoiceItemBir öğe için seçenekleri bir dize dizisinden ayarlar.
setChoices(choices)MultipleChoiceItemBir öğe için bir dizi seçenek belirler.
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 (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 puan değerini ayarlar.
setRequired(enabled)MultipleChoiceItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)MultipleChoiceItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
showOtherOption(enabled)MultipleChoiceItemÖğenin "diğer" seçeneği olup olmadığını belirler.

Ayrıntılı dokümanlar

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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çeneğin doğru yanıt olup olmadığı

Return

Choice: Yeni seçim

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createChoice(value, navigationItem)

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

Sayfa gezinmesi, katılımcı seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği seçtiyse gerçekleşir. Katılımcı, aynı sayfada sayfa gezinme talimatlarıyla birden fazla seçenek seçtiyse yalnızca son gezinme seçeneği geçerli olur. Sayfa gezinmesi, formun son sayfasını da etkilemez.

Parametreler

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

Return

Choice: Yeni seçim

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

createChoice(value, navigationType)

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

Sayfa gezinmesi, katılımcı seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği seçtiyse gerçekleşir. Katılımcı, aynı sayfada sayfa gezinme talimatlarıyla birden fazla seçenek seçtiyse yalnızca son gezinme seçeneği geçerli olur. Sayfa gezinmesi, formun son sayfasını da etkilemez.

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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çimle eşleşmezse istisna atar.

Parametreler

AdTürAçıklama
responseStringBu çoktan seçmeli öğe için geçerli bir yanıt

Return

ItemResponse: Öğe yanıtı

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Varsa geri bildirim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Varsa geri bildirim.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHelpText()

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getIndex()

Formdaki tüm öğeler arasında öğenin dizin numarasını alır.

Return

Integer: Öğenin dizini

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTitle()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getType()

Öğenin türünü ItemType olarak temsil eder.

Return

ItemType: Öğenin türü

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

hasOtherOption()

Öğenin "diğer" seçeneği olup olmadığını belirler.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setChoiceValues(values)

Bir öğe için seçenekleri bir dize dizisinden 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[]Katılımcıların formu görüntülerken etiket olarak gördüğü seçenek değerleri dizisi

Return

MultipleChoiceItem: Zincirleme için bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setChoices(choices)

Bir öğe için bir dizi seçenek belirler. 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[]bir dizi seçenek

Return

MultipleChoiceItem: Zincirleme için bu MultipleChoiceItem

Atışlar

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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. Boş bir değer, geri bildirimi temizler.

Return

MultipleChoiceItem: Zincirleme için bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setPoints(points)

Not verilebilir 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 bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 yanıtlaması gerekip gerekmediği

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTitle(title)

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

Parametreler

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

Return

MultipleChoiceItem: Zincirleme için bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

showOtherOption(enabled)

Öğenin "diğer" seçeneği olup olmadığını belirler. 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 bu MultipleChoiceItem

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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