Class ItemResponse

ItemResponse

الرد على عنصر سؤال واحد داخل نموذج. يمكن الوصول إلى الردود على العناصر من خلال FormResponse، كما يمكن إنشاؤها من خلال أي Item تطلب من المجيب الإجابة عن سؤال. 

// 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());
  }
}

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getFeedback()Objectللحصول على الملاحظات التي تم تقديمها للإجابة المقدمة عن المجيب
getItem()Itemللحصول على عنصر السؤال الذي يجيب عنه هذا الرد.
getResponse()Objectيقدّم المجيب الإجابة التي أرسلها المجيب.
getScore()Objectالحصول على درجة الإجابة المقدَّمة من المجيب
setFeedback(feedback)ItemResponseتعمل على ضبط الملاحظات التي يجب عرضها للإجابة المُرسَلة ضِمن المجيب.
setScore(score)ItemResponseلضبط درجة الإجابة المرسَلة للمجيب

الوثائق التفصيلية

getFeedback()

للحصول على الملاحظات التي تم تقديمها للإجابة المقدمة عن المجيب

استرجاع الكرة

Object: عنصر QuizFeedback لعنصر السؤال.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getItem()

للحصول على عنصر السؤال الذي يجيب عنه هذا الرد.

استرجاع الكرة

Item: عنصر السؤال الذي يجيب عنه هذا الرد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getResponse()

يقدّم المجيب الإجابة التي أرسلها المجيب. بالنسبة إلى معظم أنواع عناصر الأسئلة، يؤدي هذا إلى عرض String.

بالنسبة لأسئلة CheckboxItem، يؤدي ذلك إلى عرض صفيف String[] يحتوي على خيارات المجيب. قد يختلف ترتيب السلاسل في الصفيفة.

بالنسبة إلى أسئلة GridItem، يؤدي ذلك إلى عرض صفيف String[] تتجاوب فيه الإجابة في الفهرس n مع السؤال في الصف n + 1 من الشبكة. إذا لم يجيب المجيب عن سؤال في الشبكة، سيتم عرض هذه الإجابة كـ ''.

بالنسبة إلى أسئلة CheckboxGridItem، يؤدي ذلك إلى عرض مصفوفة String[][] تتجاوب فيها الإجابات في فهرس الصف n مع السؤال في الصف n + 1 في شبكة مربّعات الاختيار. إذا لم يجب المجيب على سؤال في الشبكة، سيتم عرض هذه الإجابة كـ ''.

استرجاع الكرة

Object: String أو String[] أو String[][] من الإجابات عن عنصر السؤال

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getScore()

الحصول على درجة الإجابة المقدَّمة من المجيب

استرجاع الكرة

Object: قيمة السمة Double التي تمثّل نتيجة عنصر السؤال.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setFeedback(feedback)

تعمل على ضبط الملاحظات التي يجب عرضها للإجابة المُرسَلة ضِمن المجيب.

لا تعمل هذه الطريقة فعليًا على حفظ الملاحظات في "نماذج Google" حتى يتم استدعاء Form.submitGrades(responses) مع استجابة FormResponse المعدَّلة. يمكنك مراجعة setScore() للاطّلاع على مثال.

المَعلمات

الاسمTypeالوصف
feedbackObject

استرجاع الكرة

ItemResponse: عنصر ItemResponse للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setScore(score)

لضبط درجة الإجابة المرسَلة للمجيب ستؤدي القيمة الفارغة إلى محو النتيجة الحالية.

لا تؤدي هذه الطريقة فعليًا إلى حفظ النتيجة في "نماذج Google" حتى يتم استدعاء Form.submitGrades(responses) مع نماذج FormResponses المعدَّلة. 

// 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);

المَعلمات

الاسمTypeالوصف
scoreObject

استرجاع الكرة

ItemResponse: عنصر ItemResponse للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms