সামগ্রিকভাবে ফর্মের একটি প্রতিক্রিয়া। একটি FormResponse
তিনটি উপায়ে ব্যবহার করা যেতে পারে: একজন উত্তরদাতার দ্বারা জমা দেওয়া উত্তরগুলি অ্যাক্সেস করতে (দেখুন getItemResponses()
), প্রোগ্রামিকভাবে ফর্মটিতে একটি প্রতিক্রিয়া জমা দিতে ( withItemResponse(response)
দেখুন এবং submit()
), এবং এর জন্য একটি URL তৈরি করতে যে ফর্মটি প্রদত্ত উত্তরগুলি ব্যবহার করে ক্ষেত্রগুলি পূর্ব-পূরণ করে। FormResponse
গুলি একটি Form
থেকে তৈরি বা অ্যাক্সেস করা যেতে পারে।
// 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()); } }
পদ্ধতি
পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
---|---|---|
getEditResponseUrl() | String | একটি URL তৈরি করে যা ইতিমধ্যেই জমা দেওয়া প্রতিক্রিয়া সম্পাদনা করতে ব্যবহার করা যেতে পারে৷ |
getGradableItemResponses() | ItemResponse[] | একটি ফর্ম প্রতিক্রিয়াতে থাকা সমস্ত আইটেম প্রতিক্রিয়াগুলি পায়, একই ক্রমে আইটেমগুলি ফর্মে প্রদর্শিত হয়৷ |
getGradableResponseForItem(item) | ItemResponse | একটি প্রদত্ত আইটেমের জন্য একটি ফর্ম প্রতিক্রিয়া অন্তর্ভুক্ত আইটেম প্রতিক্রিয়া পায়। |
getId() | String | ফর্ম প্রতিক্রিয়া আইডি পায়. |
getItemResponses() | ItemResponse[] | একটি ফর্ম প্রতিক্রিয়াতে থাকা সমস্ত আইটেম প্রতিক্রিয়াগুলি পায়, একই ক্রমে আইটেমগুলি ফর্মে প্রদর্শিত হয়৷ |
getRespondentEmail() | String | Form.setCollectEmail(collect) সেটিং সক্ষম থাকলে যে ব্যক্তি একটি প্রতিক্রিয়া জমা দিয়েছেন তার ইমেল ঠিকানা পায়৷ |
getResponseForItem(item) | ItemResponse | একটি প্রদত্ত আইটেমের জন্য এই ফর্ম প্রতিক্রিয়া অন্তর্ভুক্ত আইটেম প্রতিক্রিয়া পায়। |
getTimestamp() | Date | একটি ফর্ম প্রতিক্রিয়া জমা দেওয়ার জন্য টাইমস্ট্যাম্প পায়৷ |
submit() | FormResponse | প্রতিক্রিয়া জমা দেয়। |
toPrefilledUrl() | String | ফর্মের জন্য একটি URL তৈরি করে যেখানে উত্তরগুলি এই ফর্ম প্রতিক্রিয়ার উত্তরগুলির উপর ভিত্তি করে পূর্বে পূরণ করা হয়৷ |
withItemGrade(gradedResponse) | FormResponse | প্রদত্ত আইটেম প্রতিক্রিয়ার গ্রেডগুলি একটি ফর্ম প্রতিক্রিয়াতে যুক্ত করে৷ |
withItemResponse(response) | FormResponse | প্রদত্ত আইটেম প্রতিক্রিয়া একটি ফর্ম প্রতিক্রিয়া যোগ করে. |
বিস্তারিত ডকুমেন্টেশন
getEditResponseUrl()
একটি 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
getGradableItemResponses()
একটি ফর্ম প্রতিক্রিয়াতে থাকা সমস্ত আইটেম প্রতিক্রিয়াগুলি পায়, একই ক্রমে আইটেমগুলি ফর্মে প্রদর্শিত হয়৷ এই পদ্ধতিটি getItemResponses()
এর অনুরূপভাবে কাজ করে, কিন্তু একটি অনুপস্থিত উত্তর গ্রেড করার অনুমতি দেওয়ার জন্য, এটি এখনও একটি ItemResponse
প্রদান করে যদি সংশ্লিষ্ট 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 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()}`); } }
প্রত্যাবর্তন
ItemResponse[]
— ফর্মের মধ্যে প্রতিটি প্রশ্ন আইটেমের প্রতিক্রিয়াগুলির একটি অ্যারে যার জন্য উত্তরদাতা একটি স্কোর পেতে পারে।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGradableResponseForItem(item)
একটি প্রদত্ত আইটেমের জন্য একটি ফর্ম প্রতিক্রিয়া অন্তর্ভুক্ত আইটেম প্রতিক্রিয়া পায়। এই পদ্ধতিটি getResponseForItem(item)
এর অনুরূপভাবে কাজ করে, কিন্তু একটি অনুপস্থিত উত্তর গ্রেড করার অনুমতি দেওয়ার জন্য, এটি এখনও একটি ItemResponse
প্রদান করে যদি সংশ্লিষ্ট Item
গ্রেড করা যায় (অর্থাৎ একটি পয়েন্ট মান থাকে), এমনকি যদি প্রকৃত প্রতিক্রিয়া না থাকে। যাইহোক, যদি 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 |
প্রত্যাবর্তন
ItemResponse
- একটি প্রদত্ত আইটেমের জন্য প্রতিক্রিয়া, বা null
যদি কোনটি বিদ্যমান না থাকে এবং আইটেমটি আনগ্রেড করা হয়।
getId()
ফর্ম প্রতিক্রিয়া আইডি পায়. ফর্মের প্রতিক্রিয়া জমা না থাকলে এই পদ্ধতিটি 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
— ফর্ম প্রতিক্রিয়ার ID, অথবা যদি ফর্ম প্রতিক্রিয়া জমা না দেওয়া হয় তাহলে null
৷
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getItemResponses()
একটি ফর্ম প্রতিক্রিয়াতে থাকা সমস্ত আইটেম প্রতিক্রিয়াগুলি পায়, একই ক্রমে আইটেমগুলি ফর্মে প্রদর্শিত হয়৷ যদি ফর্মের প্রতিক্রিয়াতে একটি প্রদত্ত TextItem
, DateItem
, TimeItem
, বা ParagraphTextItem
এর জন্য একটি প্রতিক্রিয়া না থাকে, তাহলে সেই আইটেমের জন্য ফিরে আসা ItemResponse
প্রতিক্রিয়া হিসাবে একটি খালি স্ট্রিং থাকবে৷ যদি ফর্ম প্রতিক্রিয়া অন্য কোনো আইটেম ধরনের জন্য একটি প্রতিক্রিয়া বাদ দেয়, এই পদ্ধতিটি সেই আইটেমটিকে তার প্রত্যাবর্তিত অ্যারে থেকে বাদ দেয়।
// 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()}'`); } }
প্রত্যাবর্তন
ItemResponse[]
— ফর্মের মধ্যে প্রতিটি প্রশ্ন আইটেমের প্রতিক্রিয়াগুলির একটি বিন্যাস যার জন্য উত্তরদাতা একটি উত্তর দিয়েছেন।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getRespondentEmail()
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
getResponseForItem(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 |
প্রত্যাবর্তন
ItemResponse
- একটি প্রদত্ত আইটেমের প্রতিক্রিয়া, অথবা যদি কোনটি বিদ্যমান না থাকে তবে null
।
getTimestamp()
একটি ফর্ম প্রতিক্রিয়া জমা দেওয়ার জন্য টাইমস্ট্যাম্প পায়৷
একটি ফর্ম প্রতিক্রিয়া যা স্ক্রিপ্ট তৈরি করেছে কিন্তু এখনও জমা দেয়নি, এই পদ্ধতিটি 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();
প্রত্যাবর্তন
FormResponse
— একটি নতুন তৈরি প্রতিক্রিয়া ফর্মের প্রতিক্রিয়া স্টোরে সংরক্ষিত।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
toPrefilledUrl()
ফর্মের জন্য একটি 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
withItemGrade(gradedResponse)
প্রদত্ত আইটেম প্রতিক্রিয়ার গ্রেডগুলি একটি ফর্ম প্রতিক্রিয়াতে যুক্ত করে৷ এই পদ্ধতিটি শুধুমাত্র ইতিমধ্যে জমা দেওয়া প্রতিক্রিয়াগুলির জন্য প্রযোজ্য, এবং জমা দেওয়ার পরে শুধুমাত্র সঞ্চিত গ্রেডগুলিকে প্রভাবিত করে৷ এই পদ্ধতিটি শুধুমাত্র আইটেমের প্রতিক্রিয়ার গ্রেড আপডেট করে; এটি প্রকৃত প্রতিক্রিয়াকে প্রভাবিত করে না (যেহেতু প্রতিক্রিয়া ইতিমধ্যেই জমা দেওয়া হয়েছে)। যদি এই পদ্ধতিটি একই আইটেমের জন্য একাধিকবার বলা হয় তবে শুধুমাত্র শেষ গ্রেডটি ধরে রাখা হয়। যদি ItemResponse-এ কোনো গ্রেড না থাকে, তাহলে এই পদ্ধতিটি আইটেমের জন্য গ্রেড সরিয়ে দেবে।
// Programmatically award partial credit for a given response var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var formResponses = form.getResponses(); var formItems = form.getItems(); for (var i = 0; i < formResponses.length; i++) { var formResponse = formResponses[i]; for (var j = 0; j < formItems.length; j++) { var item = formItems[j]; var points = item.asMultipleChoiceItem().getPoints(); var itemResponse = formResponse.getGradableResponseForItem(item); Logger.log('Award half credit for answers containing the word "Kennedy"'); var answer = itemResponse.getResponse(); if (answer != null && answer.includes('Kennedy')) { itemResponse.setScore(points / 2); formResponse.withItemGrade(itemResponse); } } } form.submitGrades(formResponses);
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
gradedResponse | ItemResponse |
প্রত্যাবর্তন
FormResponse
— এই FormResponse
, চেইন করার জন্য
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
withItemResponse(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 | ItemResponse |
প্রত্যাবর্তন
FormResponse
— এই FormResponse
, চেইন করার জন্য।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms