Katılımcının tarih ve saat belirtmesine olanak tanıyan bir soru öğesi. Öğelere Form ile erişilebilir veya öğe oluşturulabilir. Bu öğeler bir testte kullanıldığında notlandırılır.
// Open a form by ID and add a new date-time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
createResponse(response) | ItemResponse | Bu tarih/saat öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | DateTimeItem | Bu öğenin bir kopyasını oluşturur ve bunu formun sonuna ekler. |
getGeneralFeedback() | QuizFeedback | Not verilebilir bir soruya yanıt veren katılımcılara gösterilen geri bildirimi döndürür. |
getHelpText() | String | Öğenin yardım metnini alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır). |
getId() | Integer | Öğenin benzersiz tanımlayıcısını alır. |
getIndex() | Integer | Formdaki tüm öğeler arasında öğenin dizinini alır. |
getPoints() | Integer | Not verilebilir bir öğenin puan değerini döndürür. |
getTitle() | String | Öğenin başlığını alır (SectionHeaderItem durumunda başlık metni de denir). |
getType() | ItemType | Öğenin türünü alır (ItemType ile gösterilir). |
includesYear() | Boolean | Tarih öğesinin yıl seçeneği içerip içermediğini belirler. |
isRequired() | Boolean | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setGeneralFeedback(feedback) | DateTimeItem | Not verilebilir bir soruya (ör. manuel not vermeyi gerektiren sorular) doğru veya yanlış yanıtı olmayan yanıtlar yanıtlandığında katılımcılara gösterilecek geri bildirimi ayarlar. |
setHelpText(text) | DateTimeItem | Öğ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. |
setIncludesYear(enableYear) | DateTimeItem | Tarih öğesinin yıl ayarı içerip içermediğini belirler. |
setPoints(points) | DateTimeItem | Not verilebilir bir öğenin kaç puan değerinde olduğunu belirler. |
setRequired(enabled) | DateTimeItem | Katılımcının soruyu cevaplaması gerekip gerekmediğini belirler. |
setTitle(title) | DateTimeItem | Öğenin başlığını ayarlar (SectionHeaderItem durumunda başlık metni de denir). |
Ayrıntılı belgeler
createResponse(response)
Bu tarih/saat öğesi için yeni bir ItemResponse oluşturur. Date nesnesinin saniye alanı yok sayı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
| Ad | Tür | Açıklama |
|---|---|---|
response | Date | bir ay, gün, saat, dakika ve muhtemelen yılı temsil eden Date nesnesi |
Return
ItemResponse: Öğe yanıtı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bunu formun sonuna ekler.
Return
DateTimeItem — zincirleme bağlantı için bu DateTimeItem öğesinin kopyası
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 - geri bildirim (varsa).
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 alır (ImageItems, PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için bazen açıklama metni olarak da adlandırılır).
Return
String — öğenin yardım metni veya açıklama metni
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 kapsamların 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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 değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).
Return
String: Öğenin başlığı veya başlık metni
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ü alır (ItemType ile gösterilir).
Return
ItemType - öğenin türü
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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
Boolean — Tarih bir yıl ayarı içeriyorsa true; yoksa false
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 cevaplaması 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Not verilebilir bir soruya (ör. manuel not vermeyi gerektiren sorular) doğru veya yanlış yanıtı olmayan yanıtlar yanıtlandığında katılımcılara gösterilecek geri bildirimi ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
feedback | QuizFeedback | yeni geri bildirim |
Return
DateTimeItem — bu DateTimeItem, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (ImageItems, PageBreakItems ve SectionHeaderItems 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
DateTimeItem — bu DateTimeItem, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ı içerip içermediğini belirler. Yeni tarih öğeleri için varsayılan değer true'dir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enableYear | Boolean | Tarih bir yıl ayarı içeriyorsa true; yoksa false |
Return
DateTimeItem — bu DateTimeItem, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Not verilebilir bir öğenin kaç puan değerinde olduğunu belirler. Yeni öğeler için varsayılan değer 0'dır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
points | Integer | bir soru öğesinin değeri |
Return
DateTimeItem — bu DateTimeItem, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 cevaplaması gerekip gerekmediğini belirler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
enabled | Boolean | katılımcının soruyu cevaplaması gerekip gerekmediği |
Return
DateTimeItem - geçerli öğe (zincirleme için)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 (SectionHeaderItem durumunda başlık metni de denir).
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
title | String | yeni başlık veya üstbilgi metni |
Return
DateTimeItem — bu DateTimeItem, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms