Class ItemResponse

ÖğeYanıtı

Bir formdaki soru öğesine verilen yanıt. Öğe yanıtlarına FormResponse'ten erişilebilir ve katılımcıdan bir soruyu yanıtlamasını isteyen tüm Item'lerden 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ı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ıya ait gönderilen yanıtın puanını alır.
setFeedback(feedback)ItemResponseKatılımcıya gönderilen yanıt için gösterilmesi gereken geri bildirimi ayarlar.
setScore(score)ItemResponseKatılımcının gönderdiği yanıtın puanını belirler.

Ayrıntılı dokümanlar

getFeedback()

Katılımcının gönderdiği yanıt için verilen geri bildirimi alır.

Return

Object: Soru öğesi için QuizFeedback

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

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ı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

getResponse()

Katılımcının gönderdiği yanıtı alır. Çoğu soru öğesi türü için String döndürülür.

CheckboxItem soruları için bu işlev, katılımcını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, n dizinindeki yanıtın 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ıtlamazsa bu yanıt '' olarak döndürülür.

CheckboxGridItem soruları için bu işlev, n satır dizininde yer alan yanıtların onay kutusu tablosundaki 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ıtlamazsa bu yanıt '' olarak döndürülür.

Return

Object: Soru öğesine verilen yanıtların String veya String[] veya String[][]

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

getScore()

Katılımcıya ait gönderilen yanıtın puanını alır.

Return

Object: Soru öğesinin puanını temsil eden bir Double

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

setFeedback(feedback)

Katılımcıya gönderilen yanıt için gösterilmesi gereken geri bildirimi ayarlar.

Bu yöntem, güncellenmiş FormResponses ile Form.submitGrades(responses) çağrılana kadar geri bildirimi Forms'a kaydetmez. Örnek için bkz. setScore().

Parametreler

AdTürAçıklama
feedbackObject

Return

ItemResponse: Zincirleme için bir ItemResponse

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

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ü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".
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 bir ItemResponse

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