Katılımcının derecelendirme yapmasına olanak tanıyan bir soru öğesi. Öğelere Form'ten erişilebilir veya öğeler Form'ten oluşturulabilir. Bu öğeler, testlerde notlandırılır.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and access its properties.
const existingRatingItem = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = existingRatingItem.getRatingScaleLevel();
const ratingIcon = existingRatingItem.getRatingIcon();
// Create a new rating item.
const ratingItem = form.addRatingItem();
// Update the rating item's properties via chaining.
ratingItem.setRatingScaleLevel(7).setRatingIcon(FormApp.RatingIconType.HEART);
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
createResponse(response) | ItemResponse | Bu derecelendirme öğesi için yeni bir ItemResponse oluşturur. |
duplicate() | RatingItem | Bu öğenin bir kopyasını oluşturur ve 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 (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() | Integer | Formdaki tüm öğeler arasında öğenin dizin numarasını alır. |
getPoints() | Integer | Not verilebilir bir öğenin puan değerini döndürür. |
getRatingIcon() | RatingIconType | Derecelendirme için seçilen simgeyi alır. |
getRatingScaleLevel() | Integer | Derecelendirmenin ölçek düzeyini alı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() | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
setGeneralFeedback(feedback) | RatingItem | 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. |
setHelpText(text) | RatingItem | Öğ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) | RatingItem | Not verilebilir bir öğenin puan değerini ayarlar. |
setRatingIcon(ratingIcon) | RatingItem | Derecelendirmenin simgesini ayarlar. |
setRatingScaleLevel(ratingScaleLevel) | RatingItem | Derecelendirmenin ölçek seviyesini ayarlar. |
setRequired(enabled) | RatingItem | Katılımcının soruyu yanıtlaması gerekip gerekmediğini belirler. |
setTitle(title) | RatingItem | Öğenin başlığını (SectionHeaderItem durumunda bazen üstbilgi metni olarak adlandırılır) ayarlar. |
Ayrıntılı dokümanlar
createResponse(response)
Bu derecelendirme öğesi için yeni bir ItemResponse oluşturur.
Sağlanan response, 1 değerinden küçük veya getRatingScaleLevel() tarafından döndürülen değerden büyükse komut dosyası istisnası oluşturur.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and create a new response for it.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const response =item.createResponse(5);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
response | Integer | Bu derecelendirme öğesi için bir değer 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
RatingItem: zincirleme için bu RatingItem öğ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
getRatingIcon()
Derecelendirme için seçilen simgeyi alır.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and get its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingIcon = item.getRatingIcon();
Return
RatingIconType: Puan simgesi 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
getRatingScaleLevel()
Derecelendirmenin ölçek düzeyini alır.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and get its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
const ratingScaleLevel = item.getRatingScaleLevel();
Return
Integer: Puan ölçeği seviyesi.
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
| Ad | Tür | Açıklama |
|---|---|---|
feedback | QuizFeedback | yeni geri bildirim |
Return
RatingItem: Zincirleme için bu RatingItem
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
| Ad | Tür | Açıklama |
|---|---|---|
text | String | yeni yardım metni |
Return
RatingItem: Zincirleme için bu RatingItem
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
| Ad | Tür | Açıklama |
|---|---|---|
points | Integer | Bir soru öğesinin puan değeri |
Return
RatingItem: Zincirleme için bu RatingItem
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
setRatingIcon(ratingIcon)
Derecelendirmenin simgesini ayarlar.
Derecelendirme simgesi türü geçersizse komut dosyası istisnası oluşturur.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and set its rating icon.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingIcon(FormApp.RatingIconType.THUMB_UP);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
ratingIcon | RatingIconType | Puan simgesi türü. |
Return
RatingItem: Zincirleme için bu RatingItem.
Atışlar
Error: Puan simgesi türü geçersizse
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
setRatingScaleLevel(ratingScaleLevel)
Derecelendirmenin ölçek seviyesini ayarlar. Derecelendirme ölçeği düzeyi 3 ile 10 arasında (bu değerler dahil) olmalıdır. Yeni bir puan varsayılan olarak 3 puan ölçeği seviyesinde olur.
Belirtilen değerler izin verilen sınırların dışındaysa komut dosyası istisnası oluşturur.
// Open a form by ID
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
// Get an existing rating item and set its rating scale level.
const item = form.getItems(FormApp.ItemType.RATING)[0].asRatingItem();
item.setRatingScaleLevel(7);
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
ratingScaleLevel | Integer | Puan ölçeği seviyesi. |
Return
RatingItem: Zincirleme için bu RatingItem.
Atışlar
Error: Puan ölçeği seviyesi geçersizse
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
| Ad | Tür | Açıklama |
|---|---|---|
enabled | Boolean | Katılımcının soruyu yanıtlaması gerekip gerekmediği |
Return
RatingItem: 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
| Ad | Tür | Açıklama |
|---|---|---|
title | String | yeni başlık veya başlık metni |
Return
RatingItem: Zincirleme için bu RatingItem
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