Class ItemResponse

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 لسؤال النموذج

التفويض

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

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

---

getItem()

يحصل على سؤال النموذج الذي تجيب عنه هذه الإجابة.

الإرجاع

Item — سؤال النموذج الذي تجيب عنه هذه الإجابة

التفويض

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

• 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[][] للإجابات عن سؤال النموذج

التفويض

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

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

---

getScore()

يحصل على النتيجة للإجابة التي أرسلها المجيب.

الإرجاع

Object — Double يمثّل النتيجة لسؤال النموذج

التفويض

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

• 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 للربط

التفويض

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

• 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 للربط

التفويض

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

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