Class ItemResponse

پاسخ آیتم

پاسخ به یک مورد سوال در یک فرم. پاسخ‌های آیتم‌ها را می‌توان از طریق Form Response دریافت کرد و از هر 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(),
    );
  }
}

روش ها

روش نوع برگشت شرح مختصر
get Feedback() Object بازخوردی را دریافت می کند که برای پاسخ ارسالی پاسخ دهنده داده شده است.
get Item() Item مورد سوالی را دریافت می کند که این پاسخ به آن پاسخ می دهد.
get Response() Object پاسخی را که پاسخ دهنده ارسال کرده است دریافت می کند.
get Score() Object نمره پاسخ ارسالی پاسخ دهنده را می گیرد.
set Feedback(feedback) Item Response بازخوردی را که باید برای پاسخ ارسالی پاسخ دهنده نمایش داده شود، تنظیم می کند.
set Score(score) Item Response نمره پاسخ ارسالی پاسخ دهنده را تعیین می کند.

مستندات دقیق

get Feedback()

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

بازگشت

Object - یک Quiz Feedback برای آیتم سوال

مجوز

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

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

get Item()

مورد سوالی را دریافت می کند که این پاسخ به آن پاسخ می دهد.

بازگشت

Item - سؤالی که این پاسخ به آن پاسخ می دهد

مجوز

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

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

get Response()

پاسخی را که پاسخ دهنده ارسال کرده است دریافت می کند. برای اکثر انواع سؤالات، این یک String برمی گرداند.

برای سؤالات Checkbox Item ، یک آرایه String[] حاوی انتخاب‌های پاسخ‌دهنده را برمی‌گرداند. ترتیب رشته ها در آرایه ممکن است متفاوت باشد.

برای سوالات Grid Item ، این آرایه String[] را برمی گرداند که در آن پاسخ در شاخص n با سؤال ردیف n + 1 در شبکه مطابقت دارد. اگر پاسخ دهنده به سوالی در جدول پاسخ نداد، آن پاسخ به صورت '' برگردانده می شود.

برای سؤالات Checkbox Grid Item ، این آرایه String[][] را برمی‌گرداند که در آن پاسخ‌های موجود در فهرست ردیف n با سؤال ردیف n + 1 در شبکه چک باکس مطابقت دارد. اگر پاسخ دهنده به سوالی در جدول پاسخ نداد، آن پاسخ به صورت '' برگردانده می شود.

بازگشت

Object - یک String یا String[] یا String[][] از پاسخ‌های مورد سؤال

مجوز

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

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

get Score()

نمره پاسخ ارسالی پاسخ دهنده را می گیرد.

بازگشت

Object - Double نشان دهنده امتیاز مورد سوال

مجوز

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

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

set Feedback(feedback)

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

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

پارامترها

نام تایپ کنید توضیحات
feedback Object

بازگشت

Item Response - Item Response برای زنجیر کردن

مجوز

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

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

set Score(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".
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

بازگشت

Item Response - Item Response برای زنجیر کردن

مجوز

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

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