Class CheckboxItem

Onay kutusuÖğe

Katılımcının bir veya daha fazla onay kutusunu ve isteğe bağlı bir "diğer" alanını seçmesine olanak tanıyan bir 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 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ğrulamalarını kaldırır.
createChoice(value)ChoiceYeni bir seçim oluşturur.
createChoice(value, isCorrect)ChoiceYeni bir seçim 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()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)CheckboxItemBir öğe için seçenekleri bir dize dizisinden 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 (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.
setPoints(points)CheckboxItemNot verilebilir bir öğenin puan değerini ayarlar.
setRequired(enabled)CheckboxItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)CheckboxItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
setValidation(validation)CheckboxItemBu onay kutusu öğesinin veri doğrulamasını ayarlar.
showOtherOption(enabled)CheckboxItemÖğenin "diğer" seçeneği olup olmadığını belirler.

Ayrıntılı dokümanlar

clearValidation()

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

Return

CheckboxItem: Zincirleme için bu CheckboxItem

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)

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

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

Parametreler

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

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

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

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

CheckboxItem: Zincirleme için bu CheckboxItem

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

setValidation(validation)

Bu onay kutusu öğesinin veri doğrulamasını ayarlar. Hiçbir require işlevi çağrılmadan null veya bir doğrulama geçirilirse önceki 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ı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

CheckboxItem: Zincirleme için bu CheckboxItem

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