Class ItemResponse

ItemResponse

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öntemDönüş türüKısa açıklama
getFeedback()ObjectKatılımcının gönderdiği yanıt için verilen geri bildirimi alır.
getItem()ItemBu yanıtın yanıtladığı soru öğesini alır.
getResponse()ObjectKatılımcının gönderdiği yanıtı alır.
getScore()ObjectKatılımcının gönderdiği yanıta ilişkin puanı alır.
setFeedback(feedback)ItemResponseKatılımcının gönderdiği yanıt için görüntülenmesi gereken geri bildirimi ayarlar.
setScore(score)ItemResponseKatı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

AdTürAçıklama
feedbackObject

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

AdTürAçıklama
scoreObject

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