Katılımcının, numaralandırılmış bir radyo düğmesi dizisinden bir seçenek seçmesine olanak tanıyan soru öğesi. Öğelere Form'ten erişilebilir veya bu klasörden öğe oluşturulabilir. Bu öğeler, testlerde notlandırılır.
// Open a form by ID and add a new scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 |
|---|---|---|
create | Item | Bu ölçek öğesi için yeni bir Item oluşturur. |
duplicate() | Scale | Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler. |
get | Quiz | Not verilebilir bir soruya yanıt veren katılımcılara gösterilen geri bildirimi döndürür. |
get | String | Öğenin yardım metnini (Image, Page ve Section gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır. |
get | Integer | Öğenin benzersiz tanımlayıcısını alır. |
get | Integer | Formdaki tüm öğeler arasında öğenin dizin numarasını alır. |
get | String | Ölçeğin alt sınırının (varsa) etiketini alır. |
get | Integer | Ölçeğin alt sınırını alır. |
get | Integer | Not verilebilir bir öğenin puan değerini döndürür. |
get | String | Ölçeğin üst sınırının (varsa) etiketini alır. |
get | String | Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) alır. |
get | Item | Öğenin türünü Item olarak temsil eder. |
get | Integer | Ölçeğin üst sınırını alır. |
is | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Scale | Ölçeğin alt ve üst sınırlarını belirler. |
set | Scale | Doğru veya yanlış yanıtı olmayan (ör. manuel notlandırma gerektiren sorular) puanlanabilir bir soruya yanıt verirken katılımcılara gösterilecek geri bildirimi ayarlar. |
set | Scale | Öğenin yardım metnini (Image, Page ve Section gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) ayarlar. |
set | Scale | Ölçeğin alt ve üst sınırları için etiketler ayarlar. |
set | Scale | Not verilebilir bir öğenin puan değerini ayarlar. |
set | Scale | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Scale | Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar. |
Ayrıntılı dokümanlar
create
Bu ölçek öğesi için yeni bir Item oluşturur. response bağımsız değişkeni öğe için belirlenen sınırların dışındaysa istisna oluşturur.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
response | Integer | Bu ölçek öğesi için bir değer yanıtı |
Return
Item: Öğ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
Scale: zincirleme için bu Scale öğ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
get
Not verilebilir bir soruya yanıt veren katılımcılara gösterilen geri bildirimi döndürür.
Return
Quiz: 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
get
Öğenin yardım metnini (Image, Page ve Section 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
get
Öğ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
get
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
get
Ölçeğin alt sınırının (varsa) etiketini alır.
Return
String: Ölçeğin alt sınırı için etiket
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
get
Ölçeğin alt sınırını alır.
Return
Integer: Ölçeğin alt sını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
get
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
get
Ölçeğin üst sınırının (varsa) etiketini alır.
Return
String: Ölçeğin üst sınırı için etiket
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
get
Öğenin başlığını (Section 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
get
Öğenin türünü Item olarak temsil eder.
Return
Item: Öğ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
get
Ölçeğin üst sınırını alır.
Return
Integer: Ölçeğin üst sını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
is
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
set
Ö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 (bu değerler dahil) olmalıdır. Yeni bir ölçeğin varsayılan alt sınırı 1, üst sınırı ise 5'tür.
Belirtilen değerler izin verilen sınırların dışındaysa komut dosyası istisnası oluşturur. Ondalık sayılar, önceki tam sayıya yuvarlanır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
lower | Integer | yeni alt sınır |
upper | Integer | yeni üst sınır |
Return
Scale: Zincirleme için bu Scale
Atışlar
Error: Alt veya üst sınır geçersizse
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
set
Doğru veya yanlış yanıtı olmayan (ör. manuel notlandırma gerektiren sorular) puanlanabilir bir soruya yanıt verirken katılımcılara gösterilecek geri bildirimi ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
feedback | Quiz | yeni geri bildirim |
Return
Scale: Zincirleme için bu Scale
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
set
Öğenin yardım metnini (Image, Page ve Section 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
Scale: Zincirleme için bu Scale
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
set
Ölçeğin alt ve üst sınırları için etiketler 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
Scale: Zincirleme için bu Scale
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
set
Not verilebilir bir öğenin puan değerini ayarlar. Yeni öğeler için varsayılan değer 0'dır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
points | Integer | Bir soru öğesinin puan değeri |
Return
Scale: Zincirleme için bu Scale
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
set
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 yanıtlaması gerekip gerekmediği |
Return
Scale: 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
set
Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
title | String | yeni başlık veya başlık metni |
Return
Scale: Zincirleme için bu Scale
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