Katılımcının tarih ve saat belirtmesine olanak tanıyan bir soru öğesi. Öğelere
Form
kullanılarak oluşturuldu. 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 formun sonuna ekler. |
getGeneralFeedback() | QuizFeedback | Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilen geri bildirimi döndürür. |
getHelpText() | String | Öğenin yardım metnini alır (bazen ImageItems , PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için 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ından öğ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 olması halinde bazen üstbilgi metni olarak da adlandırılır). |
getType() | ItemType | Öğenin ItemType ile gösterilen türünü alır. |
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 | Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilecek geri bildirimi belirler. (ör. manuel notlandırma gerektiren sorular) doğru veya yanlış bir yanıtı olmayanlar |
setHelpText(text) | DateTimeItem | Öğenin yardım metnini ayarlar (ImageItems , PageBreakItems ve SectionHeaderItems gibi düzen öğeleri için açıklama metni de denir). |
setIncludesYear(enableYear) | DateTimeItem | Tarih öğesinin yıl ayarı içerip içermediğini belirler. |
setPoints(points) | DateTimeItem | Not verilebilir bir öğenin sahip olduğu puan sayısını ayarlar. |
setRequired(enabled) | DateTimeItem | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
setTitle(title) | DateTimeItem | Öğenin başlığını ayarlar (SectionHeaderItem özelliğinde bazen başlık metni olarak da 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ı yok sayılır; varsayılan olarak yıl, ay, gün, saat ve dakika alanları kullanılır. Eğer
setIncludesYear(enabled)
, false
olarak ayarlandı ve yıl
yok sayılır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
response | Date | bir Date ay, gün, saat, dakika ve muhtemelen
yıl |
Return
ItemResponse
- öğe yanıtı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilen geri bildirimi döndürür.
Return
QuizFeedback
— varsa geri bildirim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (bazen ImageItems
, PageBreakItems
ve SectionHeaderItems
gibi düzen öğeleri için 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 kapsamlardan bir 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 bir 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ından öğenin dizinini alır.
Return
Integer
— öğenin dizini
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 puan değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
olması halinde bazen üstbilgi metni olarak da 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 bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Öğenin ItemType
ile gösterilen türünü alır.
Return
ItemType
: Öğenin türü
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
; Değilse false
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Katılımcılara, not verilebilecek bir soruya yanıt verdiklerinde gösterilecek geri bildirimi belirler. (ör. manuel notlandırma gerektiren sorular) doğru veya yanlış bir yanıtı olmayanlar
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 kapsamlardan bir 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 ayarlar (ImageItems
, PageBreakItems
ve SectionHeaderItems
gibi düzen öğeleri için açıklama metni de denir).
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 kapsamlardan bir 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
.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
enableYear | Boolean | Tarihte yıl ayarı varsa true ; Değilse false |
Return
DateTimeItem
— bu DateTimeItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 sahip olduğu puan sayısını ayarlar. Yeni öğeler için varsayılan değer 0'dır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
points | Integer | bir soru öğesinin sahip olduğu puan sayısı |
Return
DateTimeItem
— bu DateTimeItem
, zincirleme bağlantı için
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı gerekip gerekmediğini belirler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
enabled | Boolean | katılımcının soruyu cevaplaması gerekip gerekmediğini |
Return
DateTimeItem
— geçerli öğe (zincirleme için)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
özelliğinde bazen başlık metni olarak da adlandırılır).
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms