Katılımcının bir metin bloğu girmesine olanak tanıyan bir soru öğesi. Öğelere Form
üzerinden erişilebilir veya öğeler Form
üzerinden oluşturulabilir. Bu öğeler, testlerde 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 metin öğesi için tüm veri doğrulamalarını 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 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 | Integer | Not verilebilir bir öğenin puan değerini döndürü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. |
is | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Paragraph | 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 | Paragraph | Öğ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 | Paragraph | Not verilebilir bir öğenin puan değerini ayarlar. |
set | Paragraph | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
set | Paragraph | Öğenin başlığını (Section durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar. |
set | Paragraph | Bu paragraf metin öğesinin veri doğrulamasını ayarlar. |
Ayrıntılı dokümanlar
clear Validation()
Bu paragraf metin öğesi için tüm veri doğrulamalarını kaldırır.
Return
Paragraph
: Zincirleme için bu Paragraph
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
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
: Öğ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
Paragraph
: zincirleme için bu Paragraph
öğ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 General Feedback()
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 Help Text()
Öğ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 Id()
Öğ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 Index()
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 Points()
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 Title()
Öğ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 Type()
Öğ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
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ı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 General Feedback(feedback)
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
Paragraph
: Zincirleme için bu Paragraph
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 Help Text(text)
Öğ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
Paragraph
: Zincirleme için bu Paragraph
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 Points(points)
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
Paragraph
: Zincirleme için bu Paragraph
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 Required(enabled)
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
Paragraph
: 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 Title(title)
Öğ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
Paragraph
: Zincirleme için bu Paragraph
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 Validation(validation)
Bu paragraf metin öğesinin veri doğrulamasını ayarlar. Gerekli işlevler çağrılmadan null veya doğrulama geçirilirse önceki doğrulamalar kaldırılır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
validation | Paragraph | Bu öğeye uygulanacak bir ParagraphTextValidation. |
Return
Paragraph
: Zincirleme için bu Paragraph
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