Class CheckboxItem

CheckboxItem

Katılımcının bir veya daha fazla onay kutusu seçmesine olanak tanıyan bir soru öğesi ve isteğe bağlı bir "diğer" alanı. Öğeler, Form kullanılarak Form.addCheckboxItem() gibi yöntemlerle oluşturulur veya bunlara erişilir. Bu öğeler, testlerde kullanıldığında otomatik olarak puanlandırılır. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

Yöntemler

YöntemDönüş türüKısa açıklama
clearValidation()CheckboxItemBu onay kutusu öğesiyle ilgili tüm veri doğrulamayı kaldırır.
createChoice(value)ChoiceYeni bir seçenek oluşturur.
createChoice(value, isCorrect)ChoiceYeni bir seçenek oluşturur.
createResponse(responses)ItemResponseBu onay kutusu öğesi için yeni bir ItemResponse oluşturur.
duplicate()CheckboxItemBu öğ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)CheckboxItemBir öğenin seçeneklerini bir dizi dizeden ayarlar.
setChoices(choices)CheckboxItemBir öğe için bir dizi seçenek belirler.
setFeedbackForCorrect(feedback)CheckboxItemKatılımcılar bir soruyu doğru yanıtladığında gösterilecek geri bildirimi ayarlar.
setFeedbackForIncorrect(feedback)CheckboxItemKatılımcılar bir soruyu yanlış yanıtladığında gösterilecek geri bildirimi ayarlar.
setHelpText(text)CheckboxItemÖğ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)CheckboxItemNot verilebilen bir öğenin puan değerini ayarlar.
setRequired(enabled)CheckboxItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setTitle(title)CheckboxItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).
setValidation(validation)CheckboxItemBu onay kutusu öğesi için veri doğrulamasını ayarlar.
showOtherOption(enabled)CheckboxItemÖğenin "diğer" seçeneğine sahip olup olmadığını ayarlar.

Ayrıntılı belgeler

clearValidation()

Bu onay kutusu öğesiyle ilgili tüm veri doğrulamayı kaldırır.

Return

CheckboxItem: Zincirleme için bu CheckboxItem

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)

Yeni bir seçenek oluşturur.

Parametreler

AdTürAçıklama
valueStringSeçeneğin değeri. Yanıtlayanlar, 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. Yanıtlayanlar, 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

createResponse(responses)

Bu onay kutusu öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni, kontrol edilmesi gereken değerleri içeren bir String[] dizisidir. showOtherOption(enabled), true olarak ayarlanmadığı sürece, herhangi bir değer bu öğe için geçerli bir seçenekle eşleşmezse istisna oluşturur.

Parametreler

AdTürAçıklama
responsesString[]Bu çoktan seçmeli öğe için geçerli yanıtlar dizisi

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

CheckboxItem: Zincirleme için bu CheckboxItem öğ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[]: Çeşitli seçenekler

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

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

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

CheckboxItem: Zincirleme için bu CheckboxItem

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 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[]çeşitli seçenekler

Return

CheckboxItem: Zincirleme için bu CheckboxItem

Verdiği hatalar

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().setText('Dogs rule, cats drool.').build(),
);

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirimi Boş değer, geri bildirimi temizler.

Return

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

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

Parametreler

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

Return

CheckboxItem: Zincirleme için bu CheckboxItem

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

setValidation(validation)

Bu onay kutusu öğesi için veri doğrulamasını ayarlar. Boş değer veya herhangi bir zorunlu işlev çağrılmadan yapılan doğrulama iletildiğinde önceki tüm doğrulamalar kaldırılır.

Parametreler

AdTürAçıklama
validationCheckboxValidationBu öğeye uygulanacak bir CheckboxValidation.

Return

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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