Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class 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ı "diğer" girin. Öğelere Form üzerinden erişebilir veya öğe oluşturabilirsiniz. Kullanıldığında bu öğeler otomatik olarak notlandırılır.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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öntem	Dönüş türü	Kısa açıklama
`clearValidation()`	`CheckboxItem`	Bu onay kutusu öğesi için tüm veri doğrulamalarını kaldırır.
`createChoice(value)`	`Choice`	Yeni bir seçenek oluşturur.
`createChoice(value, isCorrect)`	`Choice`	Yeni bir seçenek oluşturur.
`createResponse(responses)`	`ItemResponse`	Bu onay kutusu öğesi için yeni bir `ItemResponse` oluşturur.
`duplicate()`	`CheckboxItem`	Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
`getChoices()`	`Choice[]`	Bir öğeyle ilgili tüm seçenekleri alır.
`getFeedbackForCorrect()`	`QuizFeedback`	Katılımcılara bir soruya doğru yanıt verdiklerinde gösterilen geri bildirimi döndürür.
`getFeedbackForIncorrect()`	`QuizFeedback`	Katı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()`	`Integer`	Formdaki tüm öğeler arasından öğenin dizinini alır.
`getPoints()`	`Integer`	Not 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.
`hasOtherOption()`	`Boolean`	Öğede "other" öğesinin olup olmadığını belirler seçeneğini belirleyin.
`isRequired()`	`Boolean`	Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler.
`setChoiceValues(values)`	`CheckboxItem`	Bir dize dizisindeki bir öğeyle ilgili seçimleri ayarlar.
`setChoices(choices)`	`CheckboxItem`	Bir öğe için seçim dizisi ayarlar.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Katılımcılara bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Katılımcılara bir soruya yanlış yanıt verdiklerinde gösterilecek geri bildirimi ayarlar.
`setHelpText(text)`	`CheckboxItem`	Öğenin yardım metnini ayarlar (`ImageItems`, `PageBreakItems` ve `SectionHeaderItems` gibi düzen öğeleri için açıklama metni de denir).
`setPoints(points)`	`CheckboxItem`	Not verilebilir bir öğenin sahip olduğu puan sayısını ayarlar.
`setRequired(enabled)`	`CheckboxItem`	Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
`setTitle(title)`	`CheckboxItem`	Öğenin başlığını ayarlar (`SectionHeaderItem` özelliğinde bazen başlık metni olarak da adlandırılır).
`setValidation(validation)`	`CheckboxItem`	Bu onay kutusu öğesi için veri doğrulamasını ayarlar.
`showOtherOption(enabled)`	`CheckboxItem`	Öğede "other" ifadesinin bulunup bulunmadığını belirler seçeneğini belirleyin.

Ayrıntılı belgeler

`clearValidation()`

Bu onay kutusu öğesi için tüm veri doğrulamalarını kaldırır.

Return

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

`createChoice(value)`

Yeni bir seçenek oluşturur.

Parametreler

Ad	Tür	Açıklama
`value`	`String`	katı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

Ad	Tür	Açıklama
`value`	`String`	katılımcıların formu görüntülerken etiket olarak gördüğü seçimin değeri
`isCorrect`	`Boolean`	seç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

`createResponse(responses)`

Bu onay kutusu öğesi için yeni bir ItemResponse oluşturur. responses bağımsız değişkeni bir Kontrol edilmesi gereken değerleri içeren String[] dizisi. Varsa istisna atar değeri, showOtherOption(enabled) true olarak ayarlanmadığı sürece bu öğe için geçerli bir seçimle eşleşmez.

Parametreler

Ad	Tür	Açıklama
`responses`	`String[]`	Bu çoktan seçmeli öğe için geçerli bir yanıt dizisi

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

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

`hasOtherOption()`

Öğede "other" öğesinin olup olmadığını belirler seçeneğini belirleyin.

Return

Boolean — Öğede "other" değeri varsa true seçenek; Değilse false

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

Ad	Tür	Açıklama
`values`	`String[]`	katılımcıların formu görüntülerken etiketler olarak gördüğü seçim değerleri dizisi

Return

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

Ad	Tür	Açıklama
`choices`	`Choice[]`	bir dizi seçenek

Return

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

Ad	Tür	Açıklama
`feedback`	`QuizFeedback`	yeni geri bildirimi alabilirsiniz. Boş değer, geri bildirimi temizler.

Return

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

Ad	Tür	Açıklama
`feedback`	`QuizFeedback`	yeni geri bildirim

Return

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

Ad	Tür	Açıklama
`text`	`String`	yeni yardım metni

Return

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

Ad	Tür	Açıklama
`points`	`Integer`	bir soru öğesinin sahip olduğu puan sayısı

Return

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

Ad	Tür	Açıklama
`enabled`	`Boolean`	katılımcının soruyu cevaplaması gerekip gerekmediğini

Return

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

Ad	Tür	Açıklama
`title`	`String`	yeni başlık veya üstbilgi metni

Return

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

`setValidation(validation)`

Bu onay kutusu öğesi için veri doğrulamasını ayarlar. Boş değer veya hiç olmadan doğrulama iletme "gerektir" işlevi çağrıldığında önceki doğrulamalar kaldırılır.

Parametreler

Ad	Tür	Açıklama
`validation`	`CheckboxValidation`	Onay Kutusu Doğrulama'ya sahip olmanız gerekir.

Return

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

`showOtherOption(enabled)`

Öğede "other" ifadesinin bulunup bulunmadığını belirler seçeneğini belirleyin. Yeni bir CheckboxItem veya MultipleChoiceItem false.

Parametreler

Ad	Tür	Açıklama
`enabled`	`Boolean`	Öğede "other" ifadesi varsa `true` seçenek; Değilse `false`

Return

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