Class ListItem

ListItem

Katılımcıya açılır listeden bir seçenek seçmesine olanak tanıyan bir soru öğesi. Öğelere Form'ten erişilebilir veya öğeler Form'te oluşturulabilir. 

// 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?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

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 liste öğesi için yeni bir ItemResponse oluşturur.
duplicate()ListItemBu öğ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.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setChoiceValues(values)ListItemBir öğe için seçenekleri bir dize dizisinden ayarlar.
setChoices(choices)ListItemBir öğe için bir dizi seçenek belirler.
setFeedbackForCorrect(feedback)ListItemKatılımcılar bir soruyu doğru yanıtladığında gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)ListItemKatılımcılar bir soruyu yanlış yanıtladığında gösterilecek geri bildirimi ayarlar.
setHelpText(text)ListItemÖğ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)ListItemNot verilebilir bir öğenin puan değerini ayarlar.
setRequired(enabled)ListItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)ListItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.

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 liste öğesi için yeni bir ItemResponse oluşturur. 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 liste öğesi 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

ListItem: zincirleme için bu ListItem öğ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

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

ListItem: Zincirleme için bu ListItem

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

ListItem: Zincirleme için bu ListItem

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

ListItem: Zincirleme için bu ListItem

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

ListItem: Zincirleme için bu ListItem

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

ListItem: Zincirleme için bu ListItem

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

ListItem: Zincirleme için bu ListItem

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

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

ListItem: Zincirleme için bu ListItem

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