Class DataSourceSheet

DataSourceSheet

मौजूदा डेटा सोर्स की शीट को ऐक्सेस करना और उसमें बदलाव करना. नई डेटा सोर्स शीट बनाने के लिए, Spreadsheet.insertDataSourceSheet(spec) का इस्तेमाल करें.

इस क्लास का इस्तेमाल सिर्फ़ उस डेटा के साथ करें जो किसी डेटाबेस से कनेक्ट हो.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addFilter(columnName, filterCriteria)DataSourceSheetइससे डेटा सोर्स शीट पर लागू किया गया फ़िल्टर जुड़ जाता है.
asSheet()Sheetयह फ़ंक्शन, डेटा सोर्स की शीट को सामान्य शीट ऑब्जेक्ट के तौर पर दिखाता है.
autoResizeColumn(columnName)DataSourceSheetयह विकल्प, चुने गए कॉलम की चौड़ाई को अपने-आप बदल देता है.
autoResizeColumns(columnNames)DataSourceSheetयह फ़ंक्शन, तय किए गए कॉलम की चौड़ाई को अपने-आप बदलता है.
cancelDataRefresh()DataSourceSheetअगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश हो रहा है, तो यह फ़ंक्शन उसे रद्द कर देता है.
forceRefreshData()DataSourceSheetयह ऑब्जेक्ट के डेटा को रीफ़्रेश करता है. भले ही, ऑब्जेक्ट की मौजूदा स्थिति कुछ भी हो.
getColumnWidth(columnName)Integer|nullयह फ़ंक्शन, तय किए गए कॉलम की चौड़ाई दिखाता है.
getDataSource()DataSourceइस ऑब्जेक्ट से लिंक किए गए डेटा सोर्स को दिखाता है.
getFilters()DataSourceSheetFilter[]इस फ़ंक्शन से, डेटा सोर्स शीट पर लागू किए गए सभी फ़िल्टर दिखते हैं.
getSheetValues(columnName)Object[]यह फ़ंक्शन, दिए गए कॉलम के नाम के लिए, डेटा सोर्स शीट की सभी वैल्यू दिखाता है.
getSheetValues(columnName, startRow, numRows)Object[]यह फ़ंक्शन, डेटा सोर्स शीट के लिए सभी वैल्यू दिखाता है. इसके लिए, कॉलम का नाम, दी गई शुरुआती लाइन (आधारित-1), और दी गई numRows का इस्तेमाल किया जाता है.
getSortSpecs()SortSpec[]इस फ़ंक्शन से, डेटा सोर्स शीट में मौजूद सभी तरह के क्रम से जुड़े स्पेसिफ़िकेशन मिलते हैं.
getStatus()DataExecutionStatusइस फ़ंक्शन से, ऑब्जेक्ट के डेटा एक्ज़ीक्यूशन की स्थिति मिलती है.
refreshData()DataSourceSheetइस कुकी का इस्तेमाल ऑब्जेक्ट के डेटा को रीफ़्रेश करने के लिए किया जाता है.
removeFilters(columnName)DataSourceSheetयह डेटा सोर्स शीट के कॉलम पर लागू किए गए सभी फ़िल्टर हटा देता है.
removeSortSpec(columnName)DataSourceSheetयह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर लागू किए गए क्रम से लगाने के नियम को हटाता है.
setColumnWidth(columnName, width)DataSourceSheetइससे तय किए गए कॉलम की चौड़ाई सेट की जाती है.
setColumnWidths(columnNames, width)DataSourceSheetइससे तय किए गए कॉलम की चौड़ाई सेट की जाती है.
setSortSpec(columnName, ascending)DataSourceSheetयह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर क्रम से लगाने की सेटिंग सेट करता है.
setSortSpec(columnName, sortOrder)DataSourceSheetयह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर क्रम से लगाने की सेटिंग सेट करता है.
waitForCompletion(timeoutInSeconds)DataExecutionStatusयह फ़ंक्शन, मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. अगर तय किए गए सेकंड के बाद भी एक्ज़ीक्यूशन पूरा नहीं होता है, तो यह फ़ंक्शन टाइम आउट हो जाता है.

ज़्यादा जानकारी वाला दस्तावेज़

addFilter(columnName, filterCriteria)

इससे डेटा सोर्स शीट पर लागू किया गया फ़िल्टर जुड़ जाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringउस कॉलम का नाम जिस पर यह फ़िल्टर लागू करना है.
filterCriteriaFilterCriteriaफ़िल्टर करने की शर्त.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट है, जिसका इस्तेमाल मेथड चेनिंग के लिए किया जाता है.

अनुमति देना

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

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

asSheet()

यह फ़ंक्शन, डेटा सोर्स की शीट को सामान्य शीट ऑब्जेक्ट के तौर पर दिखाता है.

वापसी का टिकट

Sheet — सामान्य शीट.

अनुमति देना

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

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

autoResizeColumn(columnName)

यह विकल्प, चुने गए कॉलम की चौड़ाई को अपने-आप बदल देता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringकॉलम का नाम.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट, चेनिंग के लिए है.

अनुमति देना

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

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

autoResizeColumns(columnNames)

यह फ़ंक्शन, तय किए गए कॉलम की चौड़ाई को अपने-आप बदलता है.

पैरामीटर

नामटाइपब्यौरा
columnNamesString[]अपडेट किए जाने वाले कॉलम के नामों की सूची.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट, चेनिंग के लिए है.

अनुमति देना

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

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

cancelDataRefresh()

अगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश हो रहा है, तो यह फ़ंक्शन उसे रद्द कर देता है.

इस उदाहरण में, फ़ॉर्मूला रीफ़्रेश करने की प्रोसेस को रद्द करने का तरीका बताया गया है. 

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

अगर डेटा सोर्स टाइप चालू नहीं है, तो यह फ़ंक्शन एक अपवाद दिखाता है. किसी खास तरह के डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution() तरीकों का इस्तेमाल करें.

वापसी का टिकट

DataSourceSheet — डेटा ऑब्जेक्ट.

अनुमति देना

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

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

forceRefreshData()

यह ऑब्जेक्ट के डेटा को रीफ़्रेश करता है. भले ही, ऑब्जेक्ट की मौजूदा स्थिति कुछ भी हो. ज़्यादा जानकारी के लिए, refreshData() देखें. अगर आपको इस ऑब्जेक्ट को रीफ़्रेश करने की मौजूदा प्रोसेस को रद्द करना है, तो cancelDataRefresh() देखें.

अगर डेटा सोर्स टाइप चालू नहीं है, तो यह फ़ंक्शन एक अपवाद दिखाता है. किसी खास तरह के डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution() तरीकों का इस्तेमाल करें.

वापसी का टिकट

DataSourceSheet — डेटा ऑब्जेक्ट.

अनुमति देना

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

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

getColumnWidth(columnName)

यह फ़ंक्शन, तय किए गए कॉलम की चौड़ाई दिखाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringकॉलम का नाम.

वापसी का टिकट

Integer|null — कॉलम की चौड़ाई या null, अगर कॉलम डिफ़ॉल्ट चौड़ाई का इस्तेमाल करता है.

अनुमति देना

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

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

getDataSource()

इस ऑब्जेक्ट से लिंक किए गए डेटा सोर्स को दिखाता है.

वापसी का टिकट

DataSource — डेटा सोर्स.

अनुमति देना

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

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

getFilters()

इस फ़ंक्शन से, डेटा सोर्स शीट पर लागू किए गए सभी फ़िल्टर दिखते हैं.

वापसी का टिकट

DataSourceSheetFilter[] — डेटा सोर्स शीट पर लागू किए गए सभी फ़िल्टर की एक कैटगरी.

अनुमति देना

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

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

getSheetValues(columnName)

यह फ़ंक्शन, दिए गए कॉलम के नाम के लिए, डेटा सोर्स शीट की सभी वैल्यू दिखाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringडेटा सोर्स के उस कॉलम का नाम जिसके लिए वैल्यू फ़ेच करनी हैं.

वापसी का टिकट

Object[] — वैल्यू की एक-आयामी सरणी.

अनुमति देना

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

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

getSheetValues(columnName, startRow, numRows)

यह फ़ंक्शन, डेटा सोर्स शीट के लिए सभी वैल्यू दिखाता है. इसके लिए, कॉलम का नाम, दी गई शुरुआती लाइन (आधारित-1), और दी गई numRows का इस्तेमाल किया जाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringडेटा सोर्स के उस कॉलम का नाम जिसके लिए वैल्यू फ़ेच करनी हैं.
startRowIntegerवह पंक्ति जहां से वैल्यू फ़ेच करना शुरू करना है.
numRowsIntegerफ़ेच की जाने वाली पंक्तियों की संख्या.

वापसी का टिकट

Object[] — वैल्यू की एक-आयामी सरणी.

अनुमति देना

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

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

getSortSpecs()

इस फ़ंक्शन से, डेटा सोर्स शीट में मौजूद सभी तरह के क्रम से जुड़े स्पेसिफ़िकेशन मिलते हैं.

वापसी का टिकट

SortSpec[] — क्रम से लगाने की खास जानकारी की सूची.

अनुमति देना

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

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

getStatus()

इस फ़ंक्शन से, ऑब्जेक्ट के डेटा एक्ज़ीक्यूशन की स्थिति मिलती है.

वापसी का टिकट

DataExecutionStatus — डेटा प्रोसेस करने की स्थिति.

अनुमति देना

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

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

refreshData()

इस कुकी का इस्तेमाल ऑब्जेक्ट के डेटा को रीफ़्रेश करने के लिए किया जाता है.

अगर फ़िलहाल error स्थिति में है, तो अपवाद दिखाता है. स्पेसिफ़िकेशन अपडेट करने के लिए, DataSource#updateSpec() का इस्तेमाल करें. डेटा सोर्स में अचानक होने वाले बदलावों को रोकने के लिए, इस तरीके को forceRefreshData() से बेहतर माना जाता है.

अगर डेटा सोर्स टाइप चालू नहीं है, तो यह फ़ंक्शन एक अपवाद दिखाता है. किसी खास तरह के डेटा सोर्स का डेटा प्रोसेस करने के लिए, SpreadsheetApp#enable...Execution() तरीकों का इस्तेमाल करें.

वापसी का टिकट

DataSourceSheet — डेटा ऑब्जेक्ट.

अनुमति देना

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

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

removeFilters(columnName)

यह डेटा सोर्स शीट के कॉलम पर लागू किए गए सभी फ़िल्टर हटा देता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringउस कॉलम का नाम जिससे फ़िल्टर हटाने हैं.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट है, जिसका इस्तेमाल मेथड चेनिंग के लिए किया जाता है.

अनुमति देना

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

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

removeSortSpec(columnName)

यह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर लागू किए गए क्रम से लगाने के नियम को हटाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringकॉलम का नाम.

वापसी का टिकट

DataSourceSheet — चेन बनाने के लिए डेटा सोर्स शीट.

अनुमति देना

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

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

setColumnWidth(columnName, width)

इससे तय किए गए कॉलम की चौड़ाई सेट की जाती है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringकॉलम का नाम.
widthIntegerकॉलम की नई चौड़ाई.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट, चेनिंग के लिए है.

अनुमति देना

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

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

setColumnWidths(columnNames, width)

इससे तय किए गए कॉलम की चौड़ाई सेट की जाती है.

पैरामीटर

नामटाइपब्यौरा
columnNamesString[]अपडेट किए जाने वाले कॉलम के नामों की सूची.
widthIntegerकॉलम की नई चौड़ाई.

वापसी का टिकट

DataSourceSheet — यह डेटा सोर्स शीट, चेनिंग के लिए है.

अनुमति देना

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

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

setSortSpec(columnName, ascending)

यह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर क्रम से लगाने की सेटिंग सेट करता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringफ़िल्टर करने के लिए कॉलम का नाम.
ascendingBooleanअगर true है, तो कॉलम को बढ़ते क्रम में लगाएं. अगर false है, तो कॉलम को घटते क्रम में लगाएं.

वापसी का टिकट

DataSourceSheet — चेन बनाने के लिए डेटा सोर्स शीट.

अनुमति देना

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

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

setSortSpec(columnName, sortOrder)

यह फ़ंक्शन, डेटा सोर्स शीट में मौजूद किसी कॉलम पर क्रम से लगाने की सेटिंग सेट करता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringफ़िल्टर करने के लिए कॉलम का नाम.
sortOrderSortOrderक्रम से लगाने का तरीका.

वापसी का टिकट

DataSourceSheet — चेन बनाने के लिए डेटा सोर्स शीट.

अनुमति देना

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

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

waitForCompletion(timeoutInSeconds)

यह फ़ंक्शन, मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. अगर तय किए गए सेकंड के बाद भी एक्ज़ीक्यूशन पूरा नहीं होता है, तो यह फ़ंक्शन टाइम आउट हो जाता है. अगर तय समय में प्रोसेस पूरी नहीं होती है, तो यह एक अपवाद दिखाता है. हालांकि, यह डेटा प्रोसेस को रद्द नहीं करता.

पैरामीटर

नामटाइपब्यौरा
timeoutInSecondsIntegerडेटा प्रोसेस होने के लिए तय किया गया समय (सेकंड में). ज़्यादा से ज़्यादा 300 सेकंड.

वापसी का टिकट

DataExecutionStatus — डेटा प्रोसेस करने की स्थिति.

अनुमति देना

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

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