Class FormApp

ফর্মঅ্যাপ

একটি স্ক্রিপ্টকে বিদ্যমান Form খুলতে বা নতুন ফর্ম তৈরি করতে দেয়।

// Open a form by ID.
const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
const newForm = FormApp.create('Form Name');

বৈশিষ্ট্য

সম্পত্তি	প্রকার	বর্ণনা
Alignment	Alignment	ইমেজ অ্যালাইনমেন্টের প্রকারভেদসমূহের একটি তালিকা।
Destination Type	Destination Type	ফর্মের উত্তরগুলো সংরক্ষণ করতে পারে এমন গন্তব্যস্থলের প্রকারভেদের একটি তালিকা।
Feedback Type	Feedback Type	ফর্ম Feedbacks প্রকারভেদের একটি তালিকা।
Item Type	Item Type	ফর্ম Items প্রকারের একটি তালিকা।
Page Navigation Type	Page Navigation Type	পৃষ্ঠা পরিভ্রমণের সম্ভাব্য আচরণসমূহের একটি তালিকা।
Rating Icon Type	Rating Icon Type	রেটিং আইকনের প্রকারভেদের একটি তালিকা Rating Icons

পদ্ধতি

পদ্ধতি	রিটার্ন টাইপ	সংক্ষিপ্ত বিবরণ
create(title)	Form	একটি নতুন Form তৈরি করে এবং ফেরত দেয়।
create(title, isPublished)	Form	অনুরোধকৃত প্রকাশ অবস্থায় একটি নতুন Form তৈরি করে ফেরত দেয়।
create Checkbox Grid Validation()	Checkbox Grid Validation Builder	এটি একটি CheckboxGridValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি Checkbox Grid Item ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।
create Checkbox Validation()	Checkbox Validation Builder	এটি একটি CheckboxValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি Checkbox Item ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।
create Feedback()	Quiz Feedback Builder	এটি একটি QuizFeedbackBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি গ্রেডযোগ্য Item উপর ফিডব্যাক সেট করতে ব্যবহার করা যেতে পারে।
create Grid Validation()	Grid Validation Builder	এটি একটি GridValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি Grid Item ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।
create Paragraph Text Validation()	Paragraph Text Validation Builder	ParagraphTextValidationBuilder-এর একটি ইনস্ট্যান্স রিটার্ন করে, যা একটি Paragraph Text Item এ ভ্যালিডেশন সেট করতে ব্যবহার করা যেতে পারে।
create Text Validation()	Text Validation Builder	এটি একটি TextValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি Text Item এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।
get Active Form()	Form	যে কন্টেইনারে স্ক্রিপ্টটি আবদ্ধ , সেই ফর্মটি ফেরত দেয়।
get Ui()	Ui	ফর্ম এডিটরের ইউজার-ইন্টারফেস এনভায়রনমেন্টের একটি ইনস্ট্যান্স রিটার্ন করে, যা স্ক্রিপ্টটিকে মেনু, ডায়ালগ এবং সাইডবারের মতো ফিচার যোগ করার সুযোগ দেয়।
open By Id(id)	Form	নির্দিষ্ট আইডি সহ Form ফেরত দেয়।
open By Url(url)	Form	নির্দিষ্ট URL সহ Form ফেরত দেয়।

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

create(title)

একটি নতুন Form তৈরি করে এবং ফেরত দেয়। প্রদত্ত শিরোনাম null বা খালি হলে একটি ব্যতিক্রম (exception) নিক্ষেপ করে।

// Create and open a form.
const form = FormApp.create('Form Name');

প্যারামিটার

নাম	প্রকার	বর্ণনা
title	String	নতুন ফর্মটির নাম।

ফেরত

Form — নতুন ফর্ম।

নিক্ষেপ

Error — যদি প্রদত্ত শিরোনামটি null বা খালি হয়

অনুমোদন

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

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

---

create(title, isPublished)

অনুরোধকৃত প্রকাশিত অবস্থায় একটি নতুন Form তৈরি করে এবং ফেরত দেয়। প্রদত্ত শিরোনাম null বা খালি হলে একটি ব্যতিক্রম (exception) নিক্ষেপ করে।

// Create, publish and open a form.
const form = FormApp.create('Form Name', true);

প্যারামিটার

নাম	প্রকার	বর্ণনা
title	String	নতুন ফর্মটির নাম।
is Published	Boolean	ফর্মটি প্রকাশ করা উচিত কিনা।

ফেরত

Form — নতুন ফর্ম।

নিক্ষেপ

Error — যদি প্রদত্ত শিরোনামটি null বা খালি হয়

অনুমোদন

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

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

---

createCheckboxGridValidation()

এটি একটি CheckboxGridValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি CheckboxGridItem এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।

ফেরত

CheckboxGridValidationBuilder

---

createCheckboxValidation()

এটি একটি CheckboxValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি CheckboxItem এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।

ফেরত

CheckboxValidationBuilder

---

createFeedback()

এটি একটি QuizFeedbackBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি গ্রেডযোগ্য Item উপর ফিডব্যাক সেট করতে ব্যবহার করা যেতে পারে।

ফেরত

QuizFeedbackBuilder

---

createGridValidation()

এটি একটি GridValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি GridItem এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।

ফেরত

GridValidationBuilder

---

createParagraphTextValidation()

ParagraphTextValidationBuilder-এর একটি ইনস্ট্যান্স রিটার্ন করে, যা একটি ParagraphTextItem এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।

ফেরত

ParagraphTextValidationBuilder

---

createTextValidation()

এটি একটি TextValidationBuilder-এর ইনস্ট্যান্স রিটার্ন করে, যা একটি TextItem এ ভ্যালিডেশন সেট করতে ব্যবহার করা যায়।

ফেরত

TextValidationBuilder

---

getActiveForm()

যে ফর্মটির সাথে স্ক্রিপ্টটি কন্টেইনার-বাউন্ড, সেটি ফেরত দেয়। যে ফর্মগুলোর সাথে স্ক্রিপ্টটি কন্টেইনার-বাউন্ড নয়, সেগুলোর সাথে ইন্টারঅ্যাক্ট করার জন্য পরিবর্তে openById(id) বা openByUrl(url) ব্যবহার করুন।

// Get the form to which this script is bound.
const form = FormApp.getActiveForm();

ফেরত

Form — যে ফর্মের সাথে স্ক্রিপ্টটি সংযুক্ত, অথবা স্ক্রিপ্টটি কোনো ফর্মের সাথে সংযুক্ত না থাকলে null

অনুমোদন

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

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

---

getUi()

ফর্ম এডিটরের ইউজার-ইন্টারফেস এনভায়রনমেন্টের একটি ইনস্ট্যান্স রিটার্ন করে, যা স্ক্রিপ্টটিকে মেনু, ডায়ালগ এবং সাইডবারের মতো ফিচার যোগ করার সুযোগ দেয়। একটি স্ক্রিপ্ট শুধুমাত্র খোলা ফর্ম এডিটরের বর্তমান ইনস্ট্যান্সের UI-এর সাথে ইন্টারঅ্যাক্ট করতে পারে (উত্তরদাতা যে ভিউ দেখেন তার সাথে নয়), এবং শুধুমাত্র যদি স্ক্রিপ্টটি ফর্মটির সাথে বাইন্ড করা থাকে। আরও তথ্যের জন্য, মেনু , ডায়ালগ এবং সাইডবার সম্পর্কিত গাইডগুলো দেখুন।

// Add a custom menu to the active form, including a separator and a sub-menu.
function onOpen(e) {
  FormApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          FormApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

ফেরত

Ui — এই ফর্মের ইউজার-ইন্টারফেস এনভায়রনমেন্টের একটি ইনস্ট্যান্স

---

openById(id)

নির্দিষ্ট আইডি সহ Form ফেরত দেয়। আইডিটি অবৈধ হলে বা ফর্মটি খোলার অনুমতি ব্যবহারকারীর না থাকলে একটি ব্যতিক্রম (exception) প্রদর্শন করে।

// Open a form by ID.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

প্যারামিটার

নাম	প্রকার	বর্ণনা
id	String	খোলার জন্য ফর্মটির আইডি

ফেরত

Form — প্রদত্ত আইডি সহ ফর্মটি

নিক্ষেপ

Error — যদি প্রদত্ত আইডিটি অবৈধ হয় অথবা ব্যবহারকারীর পর্যাপ্ত অনুমতি না থাকে

অনুমোদন

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

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

---

openByUrl(url)

নির্দিষ্ট URL সহ Form ফেরত দেয়। URL-টি অবৈধ হলে অথবা ফর্মটি খোলার অনুমতি ব্যবহারকারীর না থাকলে একটি ব্যতিক্রম (exception) প্রদর্শন করে।

// Open a form by URL.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

প্যারামিটার

নাম	প্রকার	বর্ণনা
url	String	খোলার জন্য ফর্মটির URL

ফেরত

Form — প্রদত্ত URL সহ ফর্মটি

নিক্ষেপ

Error — যদি প্রদত্ত URL টি অবৈধ হয় অথবা ব্যবহারকারীর পর্যাপ্ত অনুমতি না থাকে

অনুমোদন

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

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