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 soru öğesi. Öğelere Form
ile erişilebilir veya öğe oluşturulabilir. Bu öğeler, testte kullanıldığında 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çim oluşturur. |
createChoice(value, isCorrect) | Choice | Yeni bir seçim 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 bunu formun sonuna ekler. |
getChoices() | Choice[] | Bir öğeyle ilgili tüm seçenekleri alır. |
getFeedbackForCorrect() | QuizFeedback | Katılımcılara 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 (ImageItems , PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen 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ında öğ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 durumunda başlık metni de denir). |
getType() | ItemType | Öğenin türünü alır (ItemType ile gösterilir). |
hasOtherOption() | Boolean | Öğede "diğer" seçeneğinin olup olmadığını belirler. |
isRequired() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setChoiceValues(values) | CheckboxItem | Bir dize dizisinden öğe için seçenekleri ayarlar. |
setChoices(choices) | CheckboxItem | Bir öğe için seçim dizisi ayarlar. |
setFeedbackForCorrect(feedback) | CheckboxItem | Katılımcılar bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Soruya yanlış yanıt verdiklerinde katılımcılara 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) | CheckboxItem | Not verilebilir bir öğenin kaç puan değerinde olduğunu belirler. |
setRequired(enabled) | CheckboxItem | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setTitle(title) | CheckboxItem | Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir). |
setValidation(validation) | CheckboxItem | Bu onay kutusu öğesi için veri doğrulamasını ayarlar. |
showOtherOption(enabled) | CheckboxItem | Öğede "diğer" seçeneği olup olmadığını belirler. |
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 kapsamların 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çim 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 kapsamların 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çim 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 cevap olup olmadığı |
Return
Choice
- yeni seçenek
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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
Ad | Tür | Açıklama |
---|---|---|
responses | String[] | bu çoktan seçmeli öğe için bir geçerli cevap dizisi |
Return
ItemResponse
: Öğe yanıtı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bunu formun sonuna ekler.
Return
CheckboxItem
— zincirleme bağlantı için bu CheckboxItem
öğesinin kopyası
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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[]
: seçimler dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getFeedbackForCorrect()
Katılımcılara soruya doğru yanıt verdiklerinde gösterilen geri bildirimi döndürür.
Return
QuizFeedback
- geri bildirim (varsa).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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
- geri bildirim (varsa).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 alır (ImageItems
, PageBreakItems
ve SectionHeaderItems
gibi düzen öğeleri için bazen 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 kapsamların 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 kapsamların 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 kapsamların biri 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 değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem
durumunda başlık metni de denir).
Return
String
: Öğenin başlığı veya başlık metni
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ü alır (ItemType
ile gösterilir).
Return
ItemType
- öğenin türü
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 kapsamların 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 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setChoiceValues(values)
Bir dize dizisinden öğe için seçenekleri ayarlar. Belirtilen dizi boşsa bir istisna atar.
// 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 etiket 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 kapsamların 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 seçim dizisi ayarlar. Belirtilen dizi boşsa veya null
öğesi içeriyorsa istisna atar.
// 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
Dekoratif yastıklar
Error
- Belirtilen dizi null
ise, boşsa veya null
öğesi içeriyorsa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 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 bildirim. Boş değer, geri bildirimi siler. |
Return
CheckboxItem
— bu CheckboxItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setFeedbackForIncorrect(feedback)
Soruya yanlış yanıt verdiklerinde katılımcılara 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 kapsamların 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 (ImageItems
, PageBreakItems
ve SectionHeaderItems
gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar.
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 kapsamların biri 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 kaç puan değerinde olduğunu belirler. Yeni öğeler için varsayılan değer 0'dır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
points | Integer | bir soru öğesinin değeri |
Return
CheckboxItem
— bu CheckboxItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 cevaplaması gerekip gerekmediğini belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
enabled | Boolean | katılımcının soruyu cevaplaması gerekip gerekmediği |
Return
CheckboxItem
- geçerli öğe (zincirleme için)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem
durumunda başlık metni de denir).
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 kapsamların 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. Herhangi bir zorunlu işlev çağrılmadığı sürece null değerini veya doğrulamanın geçirilmesi, önceki doğrulamaların kaldırılmasına neden olur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
validation | CheckboxValidation | Bu öğeye uygulanacak bir CheckboxValidation. |
Return
CheckboxItem
— bu CheckboxItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
showOtherOption(enabled)
Öğede "diğer" seçeneği olup olmadığını belirler. Yeni CheckboxItem
veya MultipleChoiceItem
için varsayılan değer false
'dir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
enabled | Boolean | Öğede "diğer" seçeneği varsa true ; yoksa false |
Return
CheckboxItem
— bu CheckboxItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms