Class NamedRange

নামযুক্ত পরিসর

একটি Range যার একটি নাম এবং আইডি থাকে, যা পরবর্তীতে খুঁজে বের করার সুবিধা দেয়। নামগুলো সবসময় অনন্য হয় না; একই ট্যাবের মধ্যে থাকা বিভিন্ন রেঞ্জের নাম একই হতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, আইডিগুলো ট্যাবের মধ্যে অনন্য হয়, যেমনটা HTML-এর আইডির ক্ষেত্রে হয়। একবার কোনো ট্যাবে একটি NamedRange যোগ করা হলে, তা আর পরিবর্তন করা যায় না, শুধু সরানো যায়।

যে কোনো স্ক্রিপ্ট যা ট্যাব অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যুক্ত করার কথা বিবেচনা করুন।

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
get Id() String এই Named Range আইডি পাওয়া যায়।
get Name() String এই Named Range নাম পায়।
get Range() Range এই Named Range সাথে সংশ্লিষ্ট উপাদানগুলোর পরিসর পাওয়া যায়।
remove() void ট্যাব থেকে এই Named Range মুছে দেয়।

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

getId()

এই NamedRange এর আইডিটি পাওয়া যায়। ট্যাবের মধ্যে আইডিটি অনন্য।

ফেরত

String — রেঞ্জটির আইডি, যা ট্যাবের মধ্যে অনন্য।

getName()

এই NamedRange এর নামটি পায়। নামটি অগত্যা অনন্য নয়।

ফেরত

String — রেঞ্জটির নাম, যা অগত্যা অনন্য নয়।

অনুমোদন

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

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

getRange()

এই NamedRange সাথে সংশ্লিষ্ট উপাদানগুলির পরিসর পায়।

ফেরত

Range — নাম এবং আইডির সাথে সংশ্লিষ্ট উপাদানগুলোর পরিসর।

অনুমোদন

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

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

remove()

ট্যাব থেকে এই NamedRange সরিয়ে দেয়। এই মেথডটি রেঞ্জের ভেতরের বিষয়বস্তু মুছে ফেলে না; এটি কেবল রেফারেন্সটি সরিয়ে দেয়। ইতিমধ্যে সরিয়ে দেওয়া হয়েছে এমন কোনো NamedRange উপর এই মেথডটি প্রয়োগ করলে তার কোনো প্রভাব পড়ে না।

অনুমোদন

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

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