Class TextItem

MetinÖğe

Katılımcıya tek bir satır metin girmesine olanak tanıyan bir soru öğesi. Öğelere Form'den erişilebilir veya öğeler Form'de oluşturulabilir. Bu öğeler, testlerde notlandırılır. 

// Open a form by ID and add a new text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addTextItem();
item.setTitle('What is your name?');

Yöntemler

YöntemDönüş türüKısa açıklama
clearValidation()TextItemBu metin öğesi için tüm veri doğrulamalarını kaldırır.
createResponse(response)ItemResponseBu metin öğesi için yeni bir ItemResponse oluşturur.
duplicate()TextItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getGeneralFeedback()QuizFeedbackNot verilebilir bir soruya yanıt veren katılımcılara gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır) alır.
getId()IntegerÖğenin benzersiz tanımlayıcısını alır.
getIndex()IntegerFormdaki tüm öğeler arasında öğenin dizin numarasını alır.
getPoints()IntegerNot verilebilir bir öğenin puan değerini döndürür.
getTitle()StringÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) alır.
getType()ItemTypeÖğenin türünü ItemType olarak temsil eder.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setGeneralFeedback(feedback)TextItemDoğ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.
setHelpText(text)TextItemÖğ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.
setPoints(points)TextItemNot verilebilir bir öğenin puan değerini ayarlar.
setRequired(enabled)TextItemKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setTitle(title)TextItemÖğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.
setValidation(validation)TextItemBu metin öğesi için veri doğrulamasını ayarlar.

Ayrıntılı dokümanlar

clearValidation()

Bu metin öğesi için tüm veri doğrulamalarını kaldırır.

Return

TextItem: Zincirleme için bu TextItem

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

createResponse(response)

Bu metin öğesi için yeni bir ItemResponse oluşturur.

Parametreler

AdTürAçıklama
responseStringÖğenin sorduğu soruya verilen yanıt

Return

ItemResponse: Öğ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

TextItem: zincirleme için bu TextItem öğ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

getGeneralFeedback()

Not verilebilir bir soruya yanıt veren katılımcılara gösterilen geri bildirimi döndürür.

Return

QuizFeedback: 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

getHelpText()

Öğenin yardım metnini (ImageItems, PageBreakItems ve SectionHeaderItems 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

getId()

Öğ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

getIndex()

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

getPoints()

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

getTitle()

Öğenin başlığını (SectionHeaderItem 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

getType()

Öğenin türünü ItemType olarak temsil eder.

Return

ItemType: Öğ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

isRequired()

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

setGeneralFeedback(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

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

TextItem: Zincirleme için bu TextItem

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

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

AdTürAçıklama
textStringyeni yardım metni

Return

TextItem: Zincirleme için bu TextItem

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

setPoints(points)

Not verilebilir bir öğenin puan değerini ayarlar. Yeni öğeler için varsayılan değer 0'dır.

Parametreler

AdTürAçıklama
pointsIntegerBir soru öğesinin puan değeri

Return

TextItem: Zincirleme için bu TextItem

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

setRequired(enabled)

Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.

Parametreler

AdTürAçıklama
enabledBooleanKatılımcının soruyu yanıtlaması gerekip gerekmediği

Return

TextItem: 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

setTitle(title)

Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
titleStringyeni başlık veya başlık metni

Return

TextItem: Zincirleme için bu TextItem

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

setValidation(validation)

Bu metin öğesi için veri doğrulamasını ayarlar. Hiçbir require işlevi çağrılmadan null veya bir doğrulama geçirilirse önceki doğrulamalar kaldırılır.

Parametreler

AdTürAçıklama
validationTextValidationBu öğeye uygulanacak bir TextValidation.

Return

TextItem: Zincirleme için bu TextItem

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