الرد على عنصر سؤال واحد داخل نموذج. يمكن الوصول إلى الردود على العناصر من خلال 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 | الوصف |
---|---|---|
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". 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 | الوصف |
---|---|---|
score | Object |
استرجاع الكرة
ItemResponse
: عنصر ItemResponse
للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms