Yanıtlayanın bir metin bloğu girmesine 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 paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
clear | Paragraph | Bu paragraf metni öğesiyle ilgili tüm veri doğrulamayı kaldırır. |
create | Item | Bu paragraf metni öğesi için yeni bir Item oluşturur. |
duplicate() | Paragraph | 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 | Öğenin formdaki tüm öğeler arasındaki 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 | Paragraph | 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 | Paragraph | Öğ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 | Paragraph | Not verilebilen bir öğenin puan değerini ayarlar. |
set | Paragraph | Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler. |
set | Paragraph | Öğenin başlığını (bazen Section durumunda başlık metni olarak da adlandırılır) ayarlar. |
set | Paragraph | Bu paragraf metni öğesi için veri doğrulamasını ayarlar. |
Ayrıntılı belgeler
clear Validation()
Bu paragraf metni öğesiyle ilgili tüm veri doğrulamayı kaldırır.
Return
Paragraph
: Zincirleme için Paragraph
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
create Response(response)
Bu paragraf metni öğesi için yeni bir Item
oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
response | String | öğenin sorduğu soruya verilen yanıt |
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
Paragraph
: Zincirleme için bu Paragraph
öğ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
Paragraph
: Zincirleme için Paragraph
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
Paragraph
: Zincirleme için Paragraph
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
Paragraph
: Zincirleme için Paragraph
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
Paragraph
: 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ı (bazen Section
durumunda başlık metni olarak da adlandırılır) ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Yeni başlık veya başlık metni |
Return
Paragraph
: Zincirleme için Paragraph
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 Validation(validation)
Bu paragraf metni öğesi için veri doğrulamasını ayarlar. null
veya gerekli işlevlerin çağrılmadığı bir Paragraph
örneği iletmek, önceki tüm doğrulamaları kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
validation | Paragraph | Bu öğeye uygulanacak bir ParagraphTextValidation. |
Return
Paragraph
: Zincirleme için Paragraph
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