Class DateTimeItem

DateTimeItem

Yanıtlayanın tarih ve saat belirtmesine olanak tanıyan bir 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 date-time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

Yöntemler

YöntemDönüş türüKısa açıklama
createResponse(response)ItemResponseBu tarih-saat öğesi için yeni bir ItemResponse oluşturur.
duplicate()DateTimeItemBu öğenin bir kopyasını oluşturur ve formun sonuna ekler.
getGeneralFeedback()QuizFeedback|nullNot verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür.
getHelpText()StringÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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 dizinini alır.
getPoints()IntegerPuan verilebilen bir öğenin puan değerini döndürür.
getTitle()StringÖğenin başlığını alır (bazen SectionHeaderItem durumunda üstbilgi metni olarak adlandırılır).
getType()ItemTypeÖğenin türünü ItemType olarak alır.
includesYear()BooleanTarih öğesinin yıl seçeneği içerip içermediğini belirler.
isRequired()BooleanKatılımcının soruyu yanıtlaması gerekip gerekmediğini belirler.
setGeneralFeedback(feedback)DateTimeItemDoğru veya yanlış yanıtı olmayan (ör. manuel puanlama gerektiren) bir soruyu yanıtlayan katılımcılara gösterilecek geri bildirimi ayarlar.
setHelpText(text)DateTimeItemÖğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.
setIncludesYear(enableYear)DateTimeItemTarih öğesinin yıl ayarını içerip içermeyeceğini belirler.
setPoints(points)DateTimeItemNot verilebilen bir öğenin puan değerini ayarlar.
setRequired(enabled)DateTimeItemKatılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.
setTitle(title)DateTimeItemÖğenin başlığını ayarlar (bazen SectionHeaderItem durumunda başlık metni olarak adlandırılır).

Ayrıntılı belgeler

createResponse(response)

Bu tarih-saat öğesi için yeni bir ItemResponse oluşturur. Date nesnesinin saniye alanı yoksayılır. Varsayılan olarak yıl, ay, gün, saat ve dakika alanları kullanılır. setIncludesYear(enabled), false olarak ayarlanırsa yıl da yoksayılır.

Parametreler

AdTürAçıklama
responseDateAy, gün, saat, dakika ve muhtemelen yılı temsil eden bir Date nesnesi

Return

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

DateTimeItem: Zincirleme için bu DateTimeItem öğ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

getGeneralFeedback()

Not verilebilen bir soruyu yanıtlayan katılımcılara gösterilen geri bildirimi döndürür.

Return

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

getHelpText()

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

getId()

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

getIndex()

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

getPoints()

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

getTitle()

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

getType()

Öğenin türünü ItemType olarak alır.

Return

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

includesYear()

Tarih öğesinin yıl seçeneği içerip içermediğini belirler.

Return

Tarih yıl ayarını içeriyorsa Boolean — true, içermiyorsa false

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

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGeneralFeedback(feedback)

Doğru veya yanlış yanıtı olmayan (ör. manuel puanlama gerektiren) bir soruyu yanıtlayan katılımcılara gösterilecek geri bildirimi ayarlar.

Parametreler

AdTürAçıklama
feedbackQuizFeedbackyeni geri bildirim

Return

DateTimeItem: Zincirleme için bu DateTimeItem

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

setHelpText(text)

Öğenin yardım metnini (bazen ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni olarak da adlandırılır) ayarlar.

Parametreler

AdTürAçıklama
textStringyeni yardım metni

Return

DateTimeItem: Zincirleme için bu DateTimeItem

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

setIncludesYear(enableYear)

Tarih öğesinin yıl ayarını içerip içermeyeceğini belirler. Yeni tarih öğeleri için varsayılan değer true'dır.

Parametreler

AdTürAçıklama
enableYearBooleantrue Tarih yıl ayarını içeriyorsa; false içermiyorsa

Return

DateTimeItem: Zincirleme için bu DateTimeItem

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

setPoints(points)

Not verilebilen 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

DateTimeItem: Zincirleme için bu DateTimeItem

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

setRequired(enabled)

Katılımcının soruyu yanıtlamasının zorunlu olup olmadığını belirler.

Parametreler

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

Return

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

setTitle(title)

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

Parametreler

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

Return

DateTimeItem: Zincirleme için bu DateTimeItem

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