পরে পুনরুদ্ধারের অনুমতি দেওয়ার জন্য একটি নাম এবং আইডি আছে এমন একটি Range
। নামগুলি অগত্যা অনন্য নয়; একই ডকুমেন্টের বিভিন্ন রেঞ্জ একই নাম শেয়ার করতে পারে, অনেকটা HTML-এর একটি ক্লাসের মতো। বিপরীতে, আইডিগুলি ডকুমেন্টের মধ্যে অনন্য, যেমন HTML-এর একটি ID। একবার একটি নথিতে একটি NamedRange
যোগ করা হলে, এটি সংশোধন করা যাবে না, শুধুমাত্র সরানো হবে।
একটি NamedRange
যে কোনো স্ক্রিপ্ট দ্বারা অ্যাক্সেস করা যেতে পারে যা নথিতে অ্যাক্সেস করে। স্ক্রিপ্টগুলির মধ্যে অনিচ্ছাকৃত দ্বন্দ্ব এড়াতে, একটি অনন্য স্ট্রিং সহ রেঞ্জের নামগুলি উপসর্গ করার কথা বিবেচনা করুন।
// Create a named range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
পদ্ধতি
পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বর্ণনা |
---|---|---|
getId() | String | এই NamedRange এর আইডি পায়। |
getName() | String | এই NamedRange এর নাম পায়। |
getRange() | Range | এই NamedRange এর সাথে যুক্ত উপাদানের পরিসীমা পায়। |
remove() | void | নথি থেকে এই NamedRange সরিয়ে দেয়। |
বিস্তারিত ডকুমেন্টেশন
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