Katılımcının bir süre belirtmesine olanak tanıyan soru öğesi. Öğelere Form üzerinden erişilebilir veya öğeler Form üzerinden oluşturulabilir. Bu öğeler, testlerde kullanıldığında notlandırılır.
// Open a form by ID and add a new duration item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
create | Item | Bu tarih öğesi için yeni bir Item oluşturur. |
duplicate() | Duration | Bu öğenin bir kopyasını oluşturur ve formun sonuna ekler. |
get | Quiz | Not verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür. |
get | String | Öğenin yardım metnini (bazen Image, Page ve Section gibi düzen öğeleri için 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 dizinini alır. |
get | Integer | Puan verilebilen bir öğenin puan değerini döndürür. |
get | String | Öğenin başlığını alır (bazen Section durumunda üstbilgi metni olarak adlandırılır). |
get | Item | Öğenin türünü Item olarak alır. |
is | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Duration | Doğru veya yanlış cevabı olmayan (ör. manuel puanlama gerektiren) bir soruya yanıt veren katılımcılara gösterilecek geri bildirimi ayarlar. |
set | Duration | Öğenin yardım metnini (bazen Image, Page ve Section gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar. |
set | Duration | Not verilebilen bir öğenin puan değerini ayarlar. |
set | Duration | Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler. |
set | Duration | Öğenin başlığını ayarlar (Section durumunda bazen başlık metni olarak adlandırılır). |
Ayrıntılı belgeler
create Response(hours, minutes, seconds)
Bu tarih öğesi için yeni bir Item oluşturur. hours, minutes ve seconds bağımsız değişkenleri, hours için 0 ile 72 arasında, minutes ve seconds için ise 0 ile 59 arasında tam sayılar olarak en iyi şekilde gösterilir. Bu sınırları aşan değerler sabitlenir: Örneğin, 24, 60, 90 değeri 24:59:59 olarak yorumlanır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
hours | Integer | Saatler, 0 ile 72 arasında bir tam sayı olarak gösterilir. |
minutes | Integer | dakikalar, 0 ile 59 arasında bir tam sayı olarak gösterilir |
seconds | Integer | saniye, 0 ile 59 arasında bir tam sayı olarak gösterilir |
Return
Item: Öğenin yanıtı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 formun sonuna ekler.
Return
Duration: Zincirleme için bu Duration öğesinin kopyası
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get General Feedback()
Not verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür.
Return
Quiz: Varsa geri bildirim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Help Text()
Öğenin yardım metnini (bazen Image, Page ve Section gibi düzen öğeleri için 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Id()
Öğ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 biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Index()
Formdaki tüm öğeler arasında öğenin dizinini alır.
Return
Integer: Öğenin dizini
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Points()
Puan verilebilen bir öğenin puan değerini döndürür.
Return
Integer: Sorunun puan değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Title()
Öğenin başlığını alır (bazen Section durumunda üstbilgi metni olarak 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 biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Type()
Öğenin türünü Item olarak alır.
Return
Item: Öğenin türü
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
is Required()
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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set General Feedback(feedback)
Doğru veya yanlış cevabı olmayan (ör. manuel puanlama gerektiren) bir soruya yanıt veren katılımcılara gösterilecek geri bildirimi ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
feedback | Quiz | yeni geri bildirim |
Return
Duration: Zincirleme için Duration
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Help Text(text)
Öğenin yardım metnini (bazen Image, Page ve Section gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | yeni yardım metni |
Return
Duration: Zincirleme için Duration
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Points(points)
Not verilebilen 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
Duration: Zincirleme için Duration
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Required(enabled)
Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enabled | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediği |
Return
Duration: Geçerli öğe (zincirleme için)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Title(title)
Öğenin başlığını ayarlar (Section durumunda bazen başlık metni olarak adlandırılır).
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
title | String | Yeni başlık veya başlık metni |
Return
Duration: Zincirleme için Duration
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms