Class ItemResponse

العنصرالاستجابة

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

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

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
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".
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);

المعلمات

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

الإرجاع

‫ItemResponse: ItemResponse لإنشاء سلسلة

التفويض

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

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