Katılımcının radyo düğmeleri listesinden veya isteğe bağlı bir "diğer" alanından seçim yapmasına olanak tanıyan bir soru öğesidir. Öğ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 multiple choice item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats'), item.createChoice('Dogs') ]) .showOtherOption(true);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
createChoice(value) | Choice | Yeni bir seçim oluşturur. |
createChoice(value, isCorrect) | Choice | Yeni bir seçim oluşturur. |
createChoice(value, navigationItem) | Choice | Belirli bir sayfa sonu öğesine atlayan sayfa gezinme seçeneğiyle yeni bir seçenek oluşturur. |
createChoice(value, navigationType) | Choice | Sayfada gezinme seçeneği bulunan yeni bir seçenek oluşturur. |
createResponse(response) | ItemResponse | Bu çoktan seçmeli öğe için yeni bir ItemResponse oluşturur. |
duplicate() | MultipleChoiceItem | 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) | MultipleChoiceItem | Bir dize dizisinden öğe için seçenekleri ayarlar. |
setChoices(choices) | MultipleChoiceItem | Bir öğe için seçim dizisi ayarlar. |
setFeedbackForCorrect(feedback) | MultipleChoiceItem | Katılımcılar bir soruya doğru yanıt verdiklerinde gösterilecek geri bildirimi ayarlar. |
setFeedbackForIncorrect(feedback) | MultipleChoiceItem | Soruya yanlış yanıt verdiklerinde katılımcılara gösterilecek geri bildirimi ayarlar. |
setHelpText(text) | MultipleChoiceItem | Öğ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) | MultipleChoiceItem | Not verilebilir bir öğenin kaç puan değerinde olduğunu belirler. |
setRequired(enabled) | MultipleChoiceItem | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setTitle(title) | MultipleChoiceItem | Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir). |
showOtherOption(enabled) | MultipleChoiceItem | Öğede "diğer" seçeneği olup olmadığını belirler. |
Ayrıntılı belgeler
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
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 ayarlanmış createChoice(value, navigationType)
işlevine eşdeğerdir. Sayfada gezinmeyi kullanan seçenekler, sayfada gezinmeyi kullanmayan seçeneklerle aynı öğede birleştirilemez.
Sayfada gezinme, katılımcı ilgili seçeneği içeren bir sayfayı tamamladıktan sonra ve yalnızca katılımcı bu seçeneği işaretlemişse gerçekleşir. Katılımcı aynı sayfada gezinme talimatlarıyla birden fazla seçenek belirlerse yalnızca son gezinme seçeneğinin etkili olur. Sayfada gezinmenin, bir formun son sayfası üzerinde de hiçbir etkisi yoktur.
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 |
navigationItem | PageBreakItem | gidilecek öğe |
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(response)
Bu çoktan seçmeli öğe için yeni bir ItemResponse
oluşturur. showOtherOption(enabled)
, true
olarak ayarlanmadığı sürece response
bağımsız değişkeni bu öğe için geçerli bir seçenekle eşleşmezse istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
response | String | bu çoktan seçmeli öğe için geçerli bir cevap |
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
MultipleChoiceItem
— zincirleme bağlantı için bu MultipleChoiceItem
öğ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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
- 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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
MultipleChoiceItem
— bu MultipleChoiceItem
, 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