Interface Item

আইটেম

একটি জেনেরিক ফর্ম আইটেম যাতে সকল আইটেমের জন্য সাধারণ বৈশিষ্ট্য, যেমন শিরোনাম এবং সহায়ক লেখা থাকে। একটি Form থেকে আইটেমগুলো অ্যাক্সেস বা তৈরি করা যায়।

টাইপ-নির্দিষ্ট প্রোপার্টিগুলো নিয়ে কাজ করতে, আইটেমটির ItemType যাচাই করার জন্য getType() ব্যবহার করুন, তারপর asCheckboxItem() এর মতো কোনো মেথড ব্যবহার করে আইটেমটিকে উপযুক্ত ক্লাসে কাস্ট করুন।

// Create a new form and add a text item.
const form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
const items = form.getItems();
const item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() === 'TEXT') {
  const textItem = item.asTextItem();
  textItem.setRequired(false);
}

ক্লাস বাস্তবায়ন করা

নাম সংক্ষিপ্ত বিবরণ

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
as Checkbox Grid Item() Checkbox Grid Item আইটেমটিকে একটি চেকবক্স গ্রিড আইটেম হিসেবে ফেরত দেয়।
as Checkbox Item() Checkbox Item আইটেমটিকে একটি চেকবক্স আইটেম হিসেবে ফেরত দেয়।
as Date Item() Date Item আইটেমটিকে একটি তারিখ আইটেম হিসাবে ফেরত দেয়।
as Date Time Item() Date Time Item আইটেমটিকে একটি তারিখ-সময় আইটেম হিসাবে ফেরত দেয়।
as Duration Item() Duration Item আইটেমটিকে একটি সময়কাল আইটেম হিসাবে ফেরত দেয়।
as Grid Item() Grid Item আইটেমটিকে একটি গ্রিড আইটেম হিসেবে ফেরত দেয়।
as Image Item() Image Item আইটেমটিকে একটি ইমেজ আইটেম হিসেবে ফেরত দেয়।
as List Item() List Item আইটেমটিকে একটি তালিকা আইটেম হিসাবে ফেরত দেয়।
as Multiple Choice Item() Multiple Choice Item আইটেমটিকে একটি বহু-নির্বাচনী আইটেম হিসেবে ফেরত দেয়।
as Page Break Item() Page Break Item আইটেমটিকে একটি পৃষ্ঠা-ভাঙ্গা আইটেম হিসেবে ফেরত দেয়।
as Paragraph Text Item() Paragraph Text Item আইটেমটিকে একটি অনুচ্ছেদ-পাঠ্য আইটেম হিসাবে ফেরত দেয়।
as Rating Item() Rating Item আইটেমটিকে রেটিং আইটেম হিসেবে ফেরত দেয়।
as Scale Item() Scale Item আইটেমটিকে একটি স্কেল আইটেম হিসাবে ফেরত দেয়।
as Section Header Item() Section Header Item আইটেমটিকে একটি সেকশন-হেডার আইটেম হিসেবে ফেরত দেয়।
as Text Item() Text Item আইটেমটিকে একটি টেক্সট আইটেম হিসেবে ফেরত দেয়।
as Time Item() Time Item পণ্যটিকে সময়-ভিত্তিক পণ্য হিসেবে ফেরত দেয়।
as Video Item() Video Item আইটেমটিকে একটি ভিডিও আইটেম হিসেবে ফেরত দেয়।
duplicate() Item এই আইটেমটির একটি অনুলিপি তৈরি করে ফর্মের শেষে যুক্ত করে।
get Help Text() String আইটেমটির সাহায্যকারী টেক্সট (help text) পাওয়া যায় ( Image Items , Page Break Items এবং Section Header Items মতো লেআউট আইটেমগুলোর ক্ষেত্রে এটিকে কখনও কখনও ডেসক্রিপশন টেক্সটও বলা হয়)।
get Id() Integer আইটেমটির অনন্য শনাক্তকারী নম্বরটি পাওয়া যায়।
get Index() Integer ফর্মের সমস্ত আইটেমের মধ্যে থেকে আইটেমটির ইন্ডেক্স খুঁজে বের করে।
get Title() String আইটেমটির শিরোনাম পায় ( Section Header Item ক্ষেত্রে এটিকে কখনও কখনও হেডার টেক্সটও বলা হয়)।
get Type() Item Type আইটেমটির ধরণ পাওয়া যায়, যা Item Type ) হিসাবে উপস্থাপিত থাকে।
set Help Text(text) Item আইটেমটির সাহায্যমূলক টেক্সট নির্ধারণ করে ( Image Items , Page Break Items এবং Section Header Items মতো লেআউট আইটেমগুলোর ক্ষেত্রে এটিকে কখনও কখনও বর্ণনামূলক টেক্সটও বলা হয়)।
set Title(title) Item আইটেমটির শিরোনাম নির্ধারণ করে ( Section Header Item ক্ষেত্রে এটিকে কখনও কখনও হেডার টেক্সটও বলা হয়)।

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

asCheckboxGridItem()

আইটেমটিকে একটি চেকবক্স গ্রিড আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই CHECKBOX_GRID না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

CheckboxGridItem — চেকবক্স গ্রিড আইটেম

নিক্ষেপ

Error — যদি আইটেমটি একটি চেকবক্স গ্রিড আইটেম না হয়

অনুমোদন

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

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

asCheckboxItem()

আইটেমটিকে একটি চেকবক্স আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই CHECKBOX না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

CheckboxItem — চেকবক্স আইটেম

নিক্ষেপ

Error — যদি আইটেমটি চেকবক্স আইটেম না হয়

অনুমোদন

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

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

asDateItem()

আইটেমটিকে একটি তারিখ আইটেম হিসাবে ফেরত দেয়। যদি ItemType আগে থেকেই DATE না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) থ্রো করে।

ফেরত

DateItem — তারিখের আইটেম

নিক্ষেপ

Error — যদি আইটেমটি তারিখ আইটেম না হয়

অনুমোদন

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

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

asDateTimeItem()

আইটেমটিকে একটি ডেট-টাইম আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই DATETIME না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

DateTimeItem — তারিখ-সময় আইটেম

নিক্ষেপ

Error — যদি আইটেমটি তারিখ-সময় আইটেম না হয়

অনুমোদন

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

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

asDurationItem()

আইটেমটিকে একটি ডিউরেশন আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই DURATION না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

DurationItem — সময়কাল আইটেম

নিক্ষেপ

Error — যদি আইটেমটি একটি সময়কাল আইটেম না হয়

অনুমোদন

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

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

asGridItem()

আইটেমটিকে একটি গ্রিড আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই GRID না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

GridItem — গ্রিড আইটেম

নিক্ষেপ

Error — যদি আইটেমটি গ্রিড আইটেম না হয়

অনুমোদন

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

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

asImageItem()

আইটেমটিকে একটি ইমেজ আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই IMAGE না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

ImageItem — ছবির আইটেম

নিক্ষেপ

Error — যদি আইটেমটি একটি ইমেজ আইটেম না হয়

asListItem()

আইটেমটিকে একটি তালিকা আইটেম হিসাবে ফেরত দেয়। যদি ItemType আগে থেকেই LIST না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম নিক্ষেপ করে।

ফেরত

ListItem — তালিকার আইটেম

নিক্ষেপ

Error — যদি আইটেমটি তালিকার আইটেম না হয়

অনুমোদন

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

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

asMultipleChoiceItem()

আইটেমটিকে একটি বহু-নির্বাচনী আইটেম হিসাবে ফেরত দেয়। যদি ItemType আগে থেকেই MULTIPLE_CHOICE না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম নিক্ষেপ করে।

ফেরত

MultipleChoiceItem — বহু-নির্বাচনী আইটেম

নিক্ষেপ

Error — যদি আইটেমটি বহু-নির্বাচনী না হয়

অনুমোদন

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

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

asPageBreakItem()

আইটেমটিকে একটি পেজ-ব্রেক আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই PAGE_BREAK না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

PageBreakItem — পৃষ্ঠা-ভাঙ্গা আইটেম

নিক্ষেপ

Error — যদি আইটেমটি একটি পেজ ব্রেক আইটেম না হয়

অনুমোদন

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

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

asParagraphTextItem()

আইটেমটিকে একটি প্যারাগ্রাফ-টেক্সট আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই PARAGRAPH_TEXT না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

অনুচ্ছেদ- ParagraphTextItem — অনুচ্ছেদ-পাঠ্য আইটেম

নিক্ষেপ

Error — যদি আইটেমটি একটি অনুচ্ছেদ টেক্সট আইটেম না হয়

অনুমোদন

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

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

asRatingItem()

আইটেমটিকে একটি রেটিং আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই RATING না হয়ে থাকে, তাহলে একটি ScriptingException থ্রো করে।

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Fetch any item which is of type rating.
const item = form.getItems(FormApp.ItemType.RATING)[0];

// Convert the item to a rating item.
const ratingItem = item.asRatingItem();

ফেরত

RatingItem — রেটিং দেওয়ার বিষয়টি।

নিক্ষেপ

Error — যদি আইটেমটি রেটিং দেওয়ার মতো আইটেম না হয়

অনুমোদন

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

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

asScaleItem()

আইটেমটিকে একটি স্কেল আইটেম হিসাবে ফেরত দেয়। যদি ItemType আগে থেকেই SCALE না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম থ্রো করে।

ফেরত

ScaleItem — স্কেল আইটেম

নিক্ষেপ

Error — যদি আইটেমটি স্কেল আইটেম না হয়

অনুমোদন

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

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

asSectionHeaderItem()

আইটেমটিকে একটি সেকশন-হেডার আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই SECTION_HEADER না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

SectionHeaderItem — সেকশন-হেডার আইটেম

নিক্ষেপ

Error — যদি আইটেমটি সেকশন হেডার আইটেম না হয়

অনুমোদন

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

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

asTextItem()

আইটেমটিকে একটি টেক্সট আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই TEXT না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

TextItem — টেক্সট আইটেম

নিক্ষেপ

Error — যদি আইটেমটি টেক্সট আইটেম না হয়

অনুমোদন

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

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

asTimeItem()

আইটেমটিকে একটি টাইম আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই TIME না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

TimeItem — সময় আইটেম

নিক্ষেপ

Error — যদি আইটেমটি সময়-ভিত্তিক আইটেম না হয়

অনুমোদন

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

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

asVideoItem()

আইটেমটিকে একটি ভিডিও আইটেম হিসেবে ফেরত দেয়। যদি ItemType আগে থেকেই VIDEO না হয়ে থাকে, তাহলে একটি স্ক্রিপ্টিং এক্সেপশন থ্রো করে।

ফেরত

VideoItem — ভিডিও আইটেমটি

নিক্ষেপ

Error — যদি আইটেমটি ভিডিও আইটেম না হয়

duplicate()

এই আইটেমটির একটি অনুলিপি তৈরি করে ফর্মের শেষে যুক্ত করে।

ফেরত

Item — এই Item একটি প্রতিলিপি, চেইন করার জন্য।

অনুমোদন

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

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

getHelpText()

আইটেমটির সাহায্যকারী টেক্সট (help text) পায় (যা ImageItems , PageBreakItems , এবং SectionHeaderItems মতো লেআউট আইটেমগুলোর ক্ষেত্রে কখনও কখনও ডেসক্রিপশন টেক্সট (description text) নামেও পরিচিত)।

ফেরত

String — আইটেমটির সাহায্যমূলক লেখা বা বিবরণমূলক লেখা

অনুমোদন

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

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

getId()

আইটেমটির অনন্য শনাক্তকারী নম্বরটি পাওয়া যায়।

ফেরত

Integer — আইটেমটির আইডি

অনুমোদন

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

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

getIndex()

ফর্মের সমস্ত আইটেমের মধ্যে থেকে আইটেমটির ইন্ডেক্স খুঁজে বের করে।

ফেরত

Integer — আইটেমটির সূচক

অনুমোদন

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

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

getTitle()

আইটেমটির শিরোনাম (যা SectionHeaderItem এর ক্ষেত্রে হেডার টেক্সট নামেও পরিচিত) পাওয়া যায়।

ফেরত

String — আইটেমের শিরোনাম বা হেডার টেক্সট

অনুমোদন

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

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

getType()

আইটেমটির ধরণ পাওয়া যায়, যা ItemType হিসেবে উপস্থাপিত থাকে।

ফেরত

ItemType — আইটেমের ধরন

অনুমোদন

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

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

setHelpText(text)

আইটেমটির সাহায্যমূলক টেক্সট নির্ধারণ করে ( ImageItems , PageBreakItems , এবং SectionHeaderItems মতো লেআউট আইটেমগুলোর ক্ষেত্রে এটিকে কখনও কখনও ডেসক্রিপশন টেক্সটও বলা হয়)।

প্যারামিটার

নাম প্রকার বর্ণনা
text String নতুন সাহায্য পাঠ্য

ফেরত

Item — এই Item , চেইন করার জন্য

অনুমোদন

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

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

setTitle(title)

আইটেমটির শিরোনাম নির্ধারণ করে (কখনও কখনও SectionHeaderItem এর ক্ষেত্রে একে হেডার টেক্সটও বলা হয়)।

প্যারামিটার

নাম প্রকার বর্ণনা
title String নতুন শিরোনাম বা হেডার টেক্সট

ফেরত

Item — এই Item , চেইন করার জন্য

অনুমোদন

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

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