Bir formdaki bir soru öğesine verilen yanıt. Öğe yanıtlarına FormResponse
adresinden erişilebilir ve yanıt verenden soruyu yanıtlamasını isteyen herhangi bir Item
öğesinden öğe oluşturulabilir.
// Open a form by ID and log the responses to each question. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var formResponses = form.getResponses(); for (var i = 0; i < formResponses.length; i++) { var formResponse = formResponses[i]; var itemResponses = formResponse.getItemResponses(); for (var j = 0; j < itemResponses.length; j++) { var itemResponse = itemResponses[j]; Logger.log('Response #%s to the question "%s" was "%s"', (i + 1).toString(), itemResponse.getItem().getTitle(), itemResponse.getResponse()); } }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getFeedback() | Object | Katılımcının gönderdiği yanıt için verilen geri bildirimi alır. |
getItem() | Item | Bu yanıtın yanıtladığı soru öğesini alır. |
getResponse() | Object | Katılımcının gönderdiği yanıtı alır. |
getScore() | Object | Katılımcının gönderdiği yanıta ilişkin puanı alır. |
setFeedback(feedback) | ItemResponse | Katılımcının gönderdiği yanıt için görüntülenmesi gereken geri bildirimi ayarlar. |
setScore(score) | ItemResponse | Katılımcının gönderdiği yanıtın puanını belirler. |
Ayrıntılı belgeler
getFeedback()
Katılımcının gönderdiği yanıt için verilen geri bildirimi alır.
Return
Object
— soru öğesi için bir QuizFeedback
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
getItem()
Bu yanıtın yanıtladığı soru öğesini alır.
Return
Item
— bu yanıtın yanıtladığı soru öğesi
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
getResponse()
Katılımcının gönderdiği yanıtı alır. Çoğu soru öğesi türü için bu, bir String
döndürür.
CheckboxItem
soruları için bu işlem, yanıtlayanın seçimlerini içeren bir String[]
dizisi döndürür. Dizideki dizelerin sırası değişiklik gösterebilir.
GridItem
soruları için bu işlem, n
dizinindeki yanıtın tablodaki n + 1
. satırdaki soruya karşılık geldiği bir String[]
dizisi döndürür. Katılımcı tablodaki bir soruyu yanıtlamadıysa bu yanıt ''
olarak döndürülür.
CheckboxGridItem
soruları için bu işlem, n
satır dizinindeki yanıtların onay kutusu ızgarasının n + 1
. satırındaki soruya karşılık geldiği bir String[][]
dizisi döndürür. Katılımcı tablodaki bir soruyu yanıtlamadıysa bu yanıt ''
olarak döndürülür.
Return
Object
— soru öğesine verilen yanıtların String
veya String[]
ya da String[][]
kadarı
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
getScore()
Katılımcının gönderdiği yanıta ilişkin puanı alır.
Return
Object
— soru öğesinin puanını temsil eden bir Double
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
setFeedback(feedback)
Katılımcının gönderdiği yanıt için görüntülenmesi gereken geri bildirimi ayarlar.
Bu yöntem, güncellenmiş FormResponses ile Form.submitGrades(responses)
çağrılana kadar geri bildirimi Formlar'a kaydetmez. Örnek için bkz. setScore()
.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
feedback | Object |
Return
ItemResponse
— zincirleme bağlantı için ItemResponse
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
setScore(score)
Katılımcının gönderdiği yanıtın puanını belirler. Boş değer, mevcut puanı siler.
Bu yöntem, güncellenmiş FormResponses ile Form.submitGrades(responses)
çağrılana kadar puanı Formlar'a kaydetmez.
// For a multiple choice question with options: "Always true", "Sometimes true", and "Never", // award half credit for responses that answered "Sometimes true". var formResponses = FormApp.getActiveForm().getResponses(); // Go through each form response for (var i = 0; i < formResponses.length; i++) { var response = formResponses[i]; var items = FormApp.getActiveForm().getItems(); // Assume it's the first item var item = items[0]; var itemResponse = response.getGradableResponseForItem(item); // Give half credit for "Sometimes true". if (itemResponse != null && itemResponse.getResponse() == 'Sometimes true') { var points = item.asMultipleChoiceItem().getPoints(); itemResponse.setScore(points * .5); // This saves the grade, but does not submit to Forms yet. response.withItemGrade(itemResponse); } } // Grades are actually submitted to Forms here. FormApp.getActiveForm().submitGrades(formResponses);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
score | Object |
Return
ItemResponse
— zincirleme bağlantı için ItemResponse
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