Class ListItem

ListItem

Katılımcının açılır listeden bir seçenek belirlemesine olanak tanıyan bir soru öğesi. Öğeler Form üzerinden erişilebilir veya böyle bir sürüm oluşturulmalıdır. 

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

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 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ı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.
isRequired()BooleanKatılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
setChoiceValues(values)ListItemBir dize dizisindeki bir öğeyle ilgili seçimleri ayarlar.
setChoices(choices)ListItemBir öğe için seçim dizisi ayarlar.
setFeedbackForCorrect(feedback)ListItemKatılımcılara bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)ListItemKatılımcılara bir soruya yanlış yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
setHelpText(text)ListItemÖğenin yardım metnini ayarlar (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir).
setPoints(points)ListItemNot verilebilir bir öğenin sahip olduğu puan sayısını ayarlar.
setRequired(enabled)ListItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)ListItemÖğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da adlandırılır).

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 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 bir istisna oluşturur.

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

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

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

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

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

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

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

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

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

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

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