Class NamedRange

NamedRange

स्प्रेडशीट में नाम वाली रेंज बनाएं, ऐक्सेस करें, और उनमें बदलाव करें. नाम वाली रेंज वे रेंज होती हैं जिनमें संबंधित स्ट्रिंग अन्य नाम. उन्हें Sheets के यूज़र इंटरफ़ेस (यूआई) में जाकर, डेटा > नाम वाली रेंज... मेन्यू.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getName()Stringइस नाम वाली रेंज का नाम लेता है.
getRange()Rangeइस नाम वाली रेंज से रेफ़रंस के तौर पर इस्तेमाल की गई रेंज हासिल करता है.
remove()voidइस नाम वाली रेंज को मिटाता है.
setName(name)NamedRangeनाम वाली रेंज का नाम सेट/अपडेट करता है.
setRange(range)NamedRangeइस नाम वाली रेंज के लिए रेंज सेट/अपडेट करता है.

विस्तृत दस्तावेज़

getName()

इस नाम वाली रेंज का नाम लेता है.

वापसी का टिकट

String — नाम वाली इस रेंज का नाम

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

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

getRange()

इस नाम वाली रेंज से रेफ़रंस के तौर पर इस्तेमाल की गई रेंज हासिल करता है.

वापसी का टिकट

Range — स्प्रेडशीट की वह रेंज जो इस नाम वाली रेंज से जुड़ी है

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

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

remove()

इस नाम वाली रेंज को मिटाता है.

// The code below deletes all the named ranges in the spreadsheet.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

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

setName(name)

नाम वाली रेंज का नाम सेट/अपडेट करता है.

// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

पैरामीटर

नामटाइपब्यौरा
nameStringनाम वाली रेंज का नया नाम.

वापसी का टिकट

NamedRange — वह रेंज जिसका नाम कॉल के ज़रिए सेट किया गया

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

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

setRange(range)

इस नाम वाली रेंज के लिए रेंज सेट/अपडेट करता है.

पैरामीटर

नामटाइपब्यौरा
rangeRangeवह स्प्रेडशीट श्रेणी जिसे इस नाम वाली श्रेणी से संबद्ध करना है.

वापसी का टिकट

NamedRange — वह नाम वाली रेंज जिसके लिए स्प्रेडशीट रेंज सेट की गई थी

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

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