Class NamedRange

नाम वालीरेंज

ऐसा Range जिसका नाम और आईडी हो, ताकि उसे बाद में वापस पाया जा सके. नाम ज़रूरी नहीं है कि यूनीक हों. एक ही टैब में कई अलग-अलग रेंज का नाम एक जैसा हो सकता है, ठीक एचटीएमएल में क्लास की तरह. इसके उलट, टैब में आईडी यूनीक होते हैं, जैसे कि एचटीएमएल में आईडी. किसी टैब में 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());

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
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