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) باستخدام FormResponses المعدّلة. يمكنك الانتقال إلى setScore() للاطّلاع على مثال.

المعلمات

الاسمالنوعالوصف
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);

المعلمات

الاسمالنوعالوصف
scoreObject

الإرجاع

ItemResponse — ItemResponse للسلسلة

التفويض

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

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