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)

بازخوردی را که باید برای پاسخ ارسالی پاسخ دهنده نمایش داده شود، تنظیم می کند.

این روش در واقع بازخورد را در Forms ذخیره نمی کند تا زمانی که Form.submitGrades(responses) با FormResponses به روز شده فراخوانی شود. برای مثال setScore() را ببینید.

مولفه های

نام	تایپ کنید	شرح
feedback	Object

برگشت

ItemResponse - یک ItemResponse برای زنجیره زدن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

---

setScore(score)

نمره پاسخ ارسالی پاسخ دهنده را تعیین می کند. یک مقدار صفر امتیاز موجود را پاک می کند.

این روش تا زمانی که Form.submitGrades(responses) با FormResponses به روز شده فراخوانی نشود، در واقع امتیاز را در Forms ذخیره نمی کند.

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

مولفه های

نام	تایپ کنید	شرح
score	Object

برگشت

ItemResponse - یک ItemResponse برای زنجیره زدن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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