Class FormResponse

ফর্ম প্রতিক্রিয়া

সম্পূর্ণ ফর্মের একটি প্রতিক্রিয়া। একটি Form Response তিনটি উপায়ে ব্যবহার করা যেতে পারে: একজন উত্তরদাতার জমা দেওয়া উত্তরগুলি অ্যাক্সেস করতে (দেখুন get Item Responses() ), প্রোগ্রাম্যাটিকভাবে ফর্মের একটি প্রতিক্রিয়া জমা দিতে (দেখুন with Item Response(response) এবং submit() ), এবং ফর্মের জন্য একটি URL তৈরি করতে যা প্রদত্ত উত্তরগুলি ব্যবহার করে ক্ষেত্রগুলি পূর্বে পূরণ করে। Form Response গুলি একটি Form থেকে তৈরি বা অ্যাক্সেস করা যেতে পারে।

// 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 Edit Response Url() String একটি URL তৈরি করে যা ইতিমধ্যে জমা দেওয়া প্রতিক্রিয়া সম্পাদনা করতে ব্যবহার করা যেতে পারে।
get Gradable Item Responses() Item Response[] ফর্মের প্রতিক্রিয়ায় থাকা সমস্ত আইটেমের প্রতিক্রিয়াগুলি, ফর্মে আইটেমগুলি যে ক্রমে প্রদর্শিত হয় সেই একই ক্রমে পায়।
get Gradable Response For Item(item) Item Response একটি প্রদত্ত আইটেমের জন্য একটি ফর্ম প্রতিক্রিয়াতে থাকা আইটেম প্রতিক্রিয়া পায়।
get Id() String|null ফর্ম প্রতিক্রিয়ার আইডি পায়।
get Item Responses() Item Response[] ফর্মের প্রতিক্রিয়ায় থাকা সমস্ত আইটেমের প্রতিক্রিয়াগুলি, ফর্মে আইটেমগুলি যে ক্রমে প্রদর্শিত হয় সেই একই ক্রমে পায়।
get Respondent Email() String যদি Form.setCollectEmail(collect) সেটিং সক্রিয় থাকে, তাহলে যিনি প্রতিক্রিয়া জমা দিয়েছেন তার ইমেল ঠিকানা পায়।
get Response For Item(item) Item Response একটি প্রদত্ত আইটেমের জন্য এই ফর্মের প্রতিক্রিয়ায় থাকা আইটেম প্রতিক্রিয়া পায়।
get Timestamp() Date ফর্মের প্রতিক্রিয়া জমা দেওয়ার জন্য টাইমস্ট্যাম্প পায়।
submit() Form Response প্রতিক্রিয়া জমা দেয়।
to Prefilled Url() String এই ফর্মের প্রতিক্রিয়ার উত্তরের উপর ভিত্তি করে যে ফর্মে উত্তরগুলি আগে থেকে পূরণ করা হয়েছে তার জন্য একটি URL তৈরি করে।
with Item Grade(gradedResponse) Form Response প্রদত্ত আইটেমের প্রতিক্রিয়ার গ্রেডগুলি একটি ফর্ম প্রতিক্রিয়াতে যোগ করে।
with Item Response(response) Form Response প্রদত্ত আইটেমের প্রতিক্রিয়াটি একটি ফর্ম প্রতিক্রিয়ায় যোগ করে।

বিস্তারিত ডকুমেন্টেশন

get Edit Response Url()

একটি URL তৈরি করে যা ইতিমধ্যে জমা দেওয়া কোনও প্রতিক্রিয়া সম্পাদনা করতে ব্যবহার করা যেতে পারে। যদি Form.setAllowResponseEdits(enabled) সেটিংটি অক্ষম করা থাকে, তাহলে লিঙ্কটি এমন একটি পৃষ্ঠায় নিয়ে যায় যেখানে ব্যাখ্যা করা হয়েছে যে ফর্ম প্রতিক্রিয়া সম্পাদনা করা অক্ষম করা হয়েছে। যারা লিঙ্কটি পরিদর্শন করেন তারা প্রতিক্রিয়া সম্পাদনা করতে পারেন, যদিও Form.setRequireLogin(requireLogin) সেটিংটি সক্রিয় থাকলে তাদের ফর্মটিতে অ্যাক্সেস সহ একটি অ্যাকাউন্টের প্রয়োজন হয়। যদি Form.setCollectEmail(collect) সেটিংটি সক্রিয় করা থাকে, তাহলে ফর্মটি মূল উত্তরদাতার ইমেল ঠিকানার পরিবর্তে প্রতিক্রিয়া সম্পাদনা করা ব্যবহারকারীর ইমেল ঠিকানা রেকর্ড করে।

স্ক্রিপ্টটি তৈরি করেছে কিন্তু এখনও জমা দেওয়া হয়নি এমন একটি ফর্ম প্রতিক্রিয়ার জন্য, এই পদ্ধতিটি null প্রদান করে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Gets the edit URL for the first form response and logs it to the console.
const editUrl = formResponse.getEditResponseUrl();
console.log(editUrl);

প্রত্যাবর্তন

String — জমা দেওয়া প্রতিক্রিয়া পরিবর্তন করার জন্য URL।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Gradable Item Responses()

ফর্মের প্রতিক্রিয়ায় থাকা সমস্ত আইটেমের প্রতিক্রিয়াগুলি ফর্মে প্রদর্শিত ক্রমে পাওয়া যায়। এই পদ্ধতিটি get Item Responses() ক্ষেত্রেও একইভাবে কাজ করে, তবে অনুপস্থিত উত্তর গ্রেড করার জন্য, যদি সংশ্লিষ্ট Item গ্রেড করা যায় (অর্থাৎ, এর একটি পয়েন্ট মান থাকে), এমনকি যদি কোনও প্রকৃত প্রতিক্রিয়া না থাকে তবে এটি একটি Item Response ফেরত দেয়। তবে, যদি Item গ্রেডেবল না হয়, তাহলে এই পদ্ধতিটি সেই আইটেমটিকে তার ফেরত অ্যারে থেকে বাদ দেয়।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in each form response.
for (const formResponse of formResponses) {
  const gradableItemsResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for each item response to the console.
  for (const gradableItemsResponse of gradableItemsResponses) {
    console.log(`${gradableItemsResponse.getItem().getTitle()}
       score ${gradableItemsResponse.getScore()}`);
  }
}

প্রত্যাবর্তন

Item Response[] — ফর্মের মধ্যে প্রতিটি প্রশ্নের উত্তরের একটি অ্যারে যার জন্য উত্তরদাতা একটি স্কোর পেতে পারেন।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Gradable Response For Item(item)

একটি প্রদত্ত আইটেমের জন্য একটি ফর্ম প্রতিক্রিয়াতে থাকা আইটেম প্রতিক্রিয়া পায়। এই পদ্ধতিটি get Response For Item(item) একইভাবে কাজ করে, কিন্তু একটি অনুপস্থিত উত্তর গ্রেড করার অনুমতি দেওয়ার জন্য, যদি সংশ্লিষ্ট Item গ্রেড করা যায় (অর্থাৎ, একটি পয়েন্ট মান আছে), এমনকি যদি প্রকৃত প্রতিক্রিয়া না থাকে তবে এটি একটি Item Response ফেরত দেয়। তবে, যদি Item গ্রেডেবল না হয়, তাহলে এই পদ্ধতিটি null ফেরত দেয়।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Gets the item responses contained in a form response.
for (const formResponse of formResponses) {
  const formItemResponses = formResponse.getGradableItemResponses();

  // Logs the title and score for responses to the first item of the form.
  const itemResponse = formResponse.getGradableResponseForItem(
      formItemResponses[0].getItem(),
  );
  console.log(
      `${itemResponse.getItem().getTitle()} score ${itemResponse.getScore()}`,
  );
}

পরামিতি

নাম আদর্শ বিবরণ
item Item

প্রত্যাবর্তন

Item Response — একটি প্রদত্ত আইটেমের জন্য রেসপন্স, অথবা যদি কোনটিই না থাকে এবং আইটেমটি গ্রেড না করা হয় তবে null


get Id()

ফর্মের প্রতিক্রিয়ার আইডি পায়। ফর্মের প্রতিক্রিয়া জমা না দেওয়া হলে এই পদ্ধতিটি null ফেরত দেয়।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the form responses and logs the ID for each form response to
// the console.
for (const formResponse of formResponses) {
  console.log(`Response ID: ${formResponse.getId()}`);
}

প্রত্যাবর্তন

String|null — ফর্মের প্রতিক্রিয়ার আইডি, অথবা যদি ফর্মের প্রতিক্রিয়া জমা না দেওয়া হয়, তাহলে null

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Item Responses()

ফর্মের প্রতিক্রিয়ায় থাকা সমস্ত আইটেমের প্রতিক্রিয়াগুলি ফর্মে প্রদর্শিত ক্রমে একই ক্রমে পাওয়া যায়। যদি ফর্মের প্রতিক্রিয়ায় কোনও প্রদত্ত Text Item , Date Item , Time Item , বা Paragraph Text Item জন্য কোনও প্রতিক্রিয়া না থাকে, তাহলে সেই আইটেমের জন্য ফেরত পাঠানো Item Response প্রতিক্রিয়ার প্রতিক্রিয়া হিসাবে একটি খালি স্ট্রিং থাকবে। যদি ফর্মের প্রতিক্রিয়া অন্য কোনও আইটেম ধরণের জন্য একটি প্রতিক্রিয়া বাদ দেয়, তাহলে এই পদ্ধতিটি সেই আইটেমটিকে তার ফেরত দেওয়া অ্যারে থেকে বাদ দেয়।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the responses to the form.
const formResponses = form.getResponses();

// Iterates over the responses.
for (const formResponse of formResponses) {
  // Gets the item responses from each form response.
  const itemResponses = formResponse.getItemResponses();

  // Iterates over the item responses.
  for (const itemResponse of itemResponses) {
    // Logs the items' questions and responses to the console.
    console.log(
        `Response to the question '${itemResponse.getItem().getTitle()}' was
      '${itemResponse.getResponse()}'`);
  }
}

প্রত্যাবর্তন

Item Response[] — উত্তরদাতা যে ফর্মের উত্তর দিয়েছেন তার মধ্যে প্রতিটি প্রশ্নের উত্তরের একটি অ্যারে।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Respondent Email()

যদি Form.setCollectEmail(collect) সেটিং সক্রিয় থাকে, তাহলে যিনি প্রতিক্রিয়া জমা দিয়েছেন তার ইমেল ঠিকানা পায়।

স্ক্রিপ্টটি তৈরি করেছে কিন্তু এখনও জমা দেওয়া হয়নি এমন একটি ফর্ম প্রতিক্রিয়ার জন্য, এই পদ্ধতিটি null প্রদান করে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each respondent's email to the console.
// To collect respondent emails, ensure that Form.setCollectEmail(collect) is
// set to true.
for (const formResponse of formResponses) {
  console.log(`Respondent Email: ${formResponse.getRespondentEmail()}`);
}

প্রত্যাবর্তন

String — যিনি এই প্রতিক্রিয়াটি জমা দিয়েছেন তার ইমেল ঠিকানা, যদি উপলব্ধ থাকে, অথবা যদি স্ক্রিপ্টটি এই প্রতিক্রিয়াটি তৈরি করে কিন্তু এখনও জমা না দেয় তবে null

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

get Response For Item(item)

একটি প্রদত্ত আইটেমের জন্য এই ফর্মের প্রতিক্রিয়ায় থাকা আইটেম প্রতিক্রিয়া পায়।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first item on the form.
const item = form.getItems()[0];

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs each response to the first item to the
// console.
for (const formResponse of formResponses) {
  const itemResponse = formResponse.getResponseForItem(item);
  console.log(itemResponse.getResponse());
}

পরামিতি

নাম আদর্শ বিবরণ
item Item

প্রত্যাবর্তন

Item Response — একটি প্রদত্ত আইটেমের জন্য রেসপন্স, অথবা যদি কোনটিই না থাকে তবে null


get Timestamp()

ফর্মের প্রতিক্রিয়া জমা দেওয়ার জন্য টাইমস্ট্যাম্প পায়।

স্ক্রিপ্টটি তৈরি করেছে কিন্তু এখনও জমা দেওয়া হয়নি এমন একটি ফর্ম প্রতিক্রিয়ার জন্য, এই পদ্ধতিটি null প্রদান করে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets an array of the form's responses.
const formResponses = form.getResponses();

// Loops through the responses and logs the timestamp of each response to the
// console.
for (const formResponse of formResponses) {
  console.log(`Timestamp: ${formResponse.getTimestamp()}`);
}

প্রত্যাবর্তন

Date — যে টাইমস্ট্যাম্পে এই প্রতিক্রিয়া জমা দেওয়া হয়েছিল, অথবা যদি স্ক্রিপ্টটি এই প্রতিক্রিয়া তৈরি করে কিন্তু এখনও জমা না দেয়, তাহলে null

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

submit()

প্রতিক্রিয়া জমা দেয়। যদি প্রতিক্রিয়া ইতিমধ্যেই জমা দেওয়া হয়ে থাকে তবে একটি স্ক্রিপ্টিং ব্যতিক্রম নিক্ষেপ করে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates an empty response for the form.
const formResponse = form.createResponse();

// Submits an empty response.
formResponse.submit();

প্রত্যাবর্তন

Form Response — ফর্মের রেসপন্স স্টোরে সংরক্ষিত একটি নতুন তৈরি রেসপন্স।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

to Prefilled Url()

এই ফর্মের প্রতিক্রিয়ার উত্তরের উপর ভিত্তি করে যে ফর্মে উত্তরগুলি আগে থেকে পূরণ করা হয়েছে তার জন্য একটি URL তৈরি করে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Gets the first form response.
const formResponse = form.getResponses()[0];

// Generates and logs the URL of a pre-filled form response based on the answers
// of the first form response.
const prefilledUrl = formResponse.toPrefilledUrl();
console.log(prefilledUrl);

প্রত্যাবর্তন

String — পূর্বে পূরণ করা উত্তর সহ একটি ফর্মের URL।

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

with Item Grade(gradedResponse)

প্রদত্ত আইটেমের প্রতিক্রিয়ার গ্রেডগুলি একটি ফর্ম প্রতিক্রিয়াতে যোগ করে। এই পদ্ধতিটি কেবলমাত্র সেই ফর্ম প্রতিক্রিয়াগুলির ক্ষেত্রে প্রযোজ্য যা ইতিমধ্যে জমা দেওয়া হয়েছে এবং জমা দেওয়ার পরে কেবল সঞ্চিত গ্রেডগুলিকে প্রভাবিত করে। এই পদ্ধতিটি কেবল আইটেম প্রতিক্রিয়ার গ্রেডগুলি আপডেট করে; এটি প্রকৃত প্রতিক্রিয়াকে প্রভাবিত করে না (যেহেতু প্রতিক্রিয়া ইতিমধ্যে জমা দেওয়া হয়েছে)। যদি একই আইটেমের জন্য এই পদ্ধতিটি একাধিকবার কল করা হয়, তবে কেবল শেষ গ্রেডটি ধরে রাখা হয়। যদি ItemResponse-এ কোনও গ্রেড না থাকে, তাহলে এই পদ্ধতিটি আইটেমের জন্য গ্রেডগুলি সরিয়ে দেয়।

// Programmatically award partial credit for a given response
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const formResponses = form.getResponses();
const formItems = form.getItems();
for (const formResponse of formResponses) {
  for (const item of formItems) {
    const points = item.asMultipleChoiceItem().getPoints();
    const itemResponse = formResponse.getGradableResponseForItem(item);
    Logger.log('Award half credit for answers containing the word "Kennedy"');
    const answer = itemResponse.getResponse();

    if (answer?.includes('Kennedy')) {
      itemResponse.setScore(points / 2);
      formResponse.withItemGrade(itemResponse);
    }
  }
}
form.submitGrades(formResponses);

পরামিতি

নাম আদর্শ বিবরণ
graded Response Item Response

প্রত্যাবর্তন

Form Response — এই Form Response , চেইনিংয়ের জন্য

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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

with Item Response(response)

প্রদত্ত আইটেমের প্রতিক্রিয়াটি একটি ফর্ম প্রতিক্রিয়াতে যোগ করে। এই পদ্ধতিটি শুধুমাত্র সেই ফর্ম প্রতিক্রিয়াগুলির ক্ষেত্রে প্রযোজ্য যা স্ক্রিপ্ট তৈরি করেছে কিন্তু এখনও জমা দেওয়া হয়নি; এটি সঞ্চিত প্রতিক্রিয়াগুলিকে প্রভাবিত করতে পারে না। যদি এই পদ্ধতিটি একই আইটেমের জন্য একাধিকবার কল করা হয়, তবে শুধুমাত্র শেষ আইটেম প্রতিক্রিয়াটি ধরে রাখা হবে।

// Opens the Forms file by its ID.
// If you created your script from within a Google Forms file, you can
// use FormApp.getActiveForm() instead.
// TODO(developer): Replace the ID with your own.
const form = FormApp.openById('abc123456');

// Creates a response for the form.
const formResponse = form.createResponse();

// Appends a checkbox item to the form.
const item = form.addCheckboxItem();

// Sets the title of the item to 'Which items are ice cream flavors?'
item.setTitle('Which items are ice cream flavors?');

// Sets choices for the item.
item.setChoices([
  item.createChoice('Vanilla'),
  item.createChoice('Strawberry'),
  item.createChoice('Brick'),
]);

// Creates a response for the item.
const response = item.createResponse(['Vanilla', 'Strawberry']);

// Adds the item response to the form response.
formResponse.withItemResponse(response);

// Submits the form response.
formResponse.submit();

পরামিতি

নাম আদর্শ বিবরণ
response Item Response

প্রত্যাবর্তন

Form Response — চেইনিংয়ের জন্য এই Form Response

অনুমোদন

এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:

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