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चुने गए कॉलम की चौड़ाई दिखाता है.
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.

अनुमति देना

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

  • 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