Class ItemResponse

ItemResponse

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öntemDönüş türüKısa açıklama
getFeedback()ObjectKatılımcının gönderdiği yanıta verilen geri bildirimi alır.
getItem()ItemBu yanıtın cevapladığı soru öğesini alır.
getResponse()ObjectKatılımcının gönderdiği yanıtı alır.
getScore()ObjectYanıtlayanın gönderdiği yanıtın puanını alır.
setFeedback(feedback)ItemResponseKatılımcının gönderdiği yanıta karşılık gösterilecek 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ı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

AdTürAçıklama
feedbackObject

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

AdTürAçıklama
scoreObject

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