Bir formdaki soru öğesine verilen yanıt. Öğe yanıtlarına FormResponse bölümünden erişilebilir ve katılımcıdan soruya cevap vermesini isteyen herhangi bir Item üzerinden oluşturulabilir.
// Open a form by ID and log the responses to each question. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const formResponses = form.getResponses(); for (let i = 0; i < formResponses.length; i++) { const formResponse = formResponses[i]; const itemResponses = formResponse.getItemResponses(); for (let j = 0; j < itemResponses.length; j++) { const 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 |
|---|---|---|
get | Object | Katılımcının gönderdiği yanıta verilen geri bildirimi alır. |
get | Item | Bu yanıtın cevapladığı soru öğesini alır. |
get | Object | Katılımcının gönderdiği yanıtı alır. |
get | Object | Yanıtlayanın gönderdiği yanıtın puanını alır. |
set | Item | Katılımcının gönderdiği yanıta karşılık gösterilecek geri bildirimi ayarlar. |
set | Item | 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ıta verilen geri bildirimi alır.
Return
Object: Soru öğesi için QuizFeedback
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
getItem()
Bu yanıtın cevapladığı soru öğesini alır.
Return
Item: Bu yanıtın cevapladığı soru öğesi
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
getResponse()
Katılımcının gönderdiği yanıtı alır. Çoğu soru öğesi türü için bu işlev String değerini döndürür.
CheckboxItem soruları için bu işlev, yanıtlayanın seçimlerini içeren bir String[] dizisi döndürür. Dizideki dizelerin sırası değişebilir.
GridItem soruları için bu işlev, dizindeki n yanıtının ızgaradaki n + 1 satırındaki soruya karşılık geldiği bir String[] dizisi döndürür. Bir katılımcı ızgaradaki bir soruyu yanıtlamadıysa bu yanıt '' olarak döndürülür.
CheckboxGridItem soruları için bu işlev, satır dizinindeki n yanıtların onay kutulu tablodaki n + 1 satırındaki soruya karşılık geldiği bir String[][] dizisi döndürür. Bir katılımcı ızgaradaki bir soruyu yanıtlamadıysa bu yanıt '' olarak döndürülür.
Return
Object: Soru öğesine verilen yanıtların String, String[] veya String[][]'ü
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
getScore()
Yanıtlayanın gönderdiği yanıtın puanını alır.
Return
Object: Soru öğesinin puanını gösteren Double
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
setFeedback(feedback)
Katılımcının gönderdiği yanıta karşılık gösterilecek 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 için ItemResponse
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
setScore(score)
Katılımcının gönderdiği yanıtın puanını belirler. Null değer, mevcut puanı temizler.
Bu yöntem, güncellenen 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". const formResponses = FormApp.getActiveForm().getResponses(); // Go through each form response for (let i = 0; i < formResponses.length; i++) { const response = formResponses[i]; const items = FormApp.getActiveForm().getItems(); // Assume it's the first item const item = items[0]; const itemResponse = response.getGradableResponseForItem(item); // Give half credit for "Sometimes true". if (itemResponse != null && itemResponse.getResponse() === 'Sometimes true') { const points = item.asMultipleChoiceItem().getPoints(); itemResponse.setScore(points * 0.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 için ItemResponse
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