Katılımcının numaralandırılmış bir dizi radyo düğmesi arasından bir seçenek belirlemesine olanak tanıyan bir soru öğesi. Öğelere Form
ile erişilebilir veya öğe oluşturulabilir. Bu öğeler bir testte kullanıldığında
not verilir.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
createResponse(response) | ItemResponse | Bu ölçek öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | ScaleItem | Bu öğenin bir kopyasını oluşturur ve bunu formun sonuna ekler. |
getGeneralFeedback() | QuizFeedback | Not verilebilir bir soruya yanıt veren katılımcılara 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. |
getLeftLabel() | String | Varsa ölçeğin alt sınırını alır. |
getLowerBound() | Integer | Ölçeğin alt sınırını getirir. |
getPoints() | Integer | Not verilebilir bir öğenin puan değerini döndürür. |
getRightLabel() | String | Varsa ölçeğin üst sınırı etiketini alı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). |
getUpperBound() | Integer | Ölçeğin üst sınırını getirir. |
isRequired() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setBounds(lower, upper) | ScaleItem | Ölçeğin alt ve üst sınırlarını belirler. |
setGeneralFeedback(feedback) | ScaleItem | Not verilebilir bir soruya (ör. manuel not vermeyi gerektiren sorular) doğru veya yanlış yanıtı olmayan yanıtlar yanıtlandığında katılımcılara gösterilecek geri bildirimi ayarlar. |
setHelpText(text) | ScaleItem | Öğ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. |
setLabels(lower, upper) | ScaleItem | Ölçeğin alt ve üst sınırları için etiketleri ayarlar. |
setPoints(points) | ScaleItem | Not verilebilir bir öğenin kaç puan değerinde olduğunu belirler. |
setRequired(enabled) | ScaleItem | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setTitle(title) | ScaleItem | Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir). |
Ayrıntılı belgeler
createResponse(response)
Bu ölçek öğesi için yeni bir ItemResponse
oluşturur. response
bağımsız değişkeni öğe için belirlenen sınırların dışındaysa istisna atar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
response | Integer | bu ölçek öğesi için bir değer yanıtı |
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
ScaleItem
— zincirleme bağlantı için bu ScaleItem
öğ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
getGeneralFeedback()
Not verilebilir bir soruya yanıt veren katılımcılara 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
getLeftLabel()
Varsa ölçeğin alt sınırını alır.
Return
String
- ölçeğin alt sınırı etiketi
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
getLowerBound()
Ölçeğin alt sınırını getirir.
Return
Integer
— ölçeğin alt sını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
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
getRightLabel()
Varsa ölçeğin üst sınırı etiketini alır.
Return
String
- ölçeğin üst sınırı etiketi
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
getUpperBound()
Ölçeğin üst sınırını getirir.
Return
Integer
— ölçeğin üst sını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
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
setBounds(lower, upper)
Ölçeğin alt ve üst sınırlarını belirler. Alt sınır 0
veya 1
olmalıdır. Üst sınır, 3
ile 10
arasında (değerler dahil) olmalıdır. Yeni bir ölçek varsayılan olarak 1
alt sınırı ve 5
üst sınırı olur.
Belirtilen değerler izin verilen sınırların dışındaysa komut dosyası istisnası oluşturur. Ondalık sayılar, bir önceki tam sayıya kısaltılır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
lower | Integer | yeni alt sınır |
upper | Integer | yeni üst sınır |
Return
ScaleItem
— bu ScaleItem
, zincirleme bağlantı için
Dekoratif yastıklar
Error
: alt veya üst sınır geçersizse
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
setGeneralFeedback(feedback)
Not verilebilir bir soruya (ör. manuel not vermeyi gerektiren sorular) doğru veya yanlış yanıtı olmayan yanıtlar yanıtlandığında katılımcılara gösterilecek geri bildirimi ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
feedback | QuizFeedback | yeni geri bildirim |
Return
ScaleItem
— bu ScaleItem
, 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
ScaleItem
— bu ScaleItem
, 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
setLabels(lower, upper)
Ölçeğin alt ve üst sınırları için etiketleri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
lower | String | alt sınır için yeni etiket |
upper | String | üst sınır için yeni etiket |
Return
ScaleItem
— bu ScaleItem
, 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
ScaleItem
— bu ScaleItem
, 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
ScaleItem
- 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
ScaleItem
— bu ScaleItem
, 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