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() مثلاً.

المعلمات

الاسم	النوع	الوصف
feedback	Object

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
score	Object

الإرجاع

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

التفويض

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

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