मौजूदा डेटा सोर्स शीट ऐक्सेस करें और उसमें बदलाव करें. नई डेटा सोर्स शीट बनाने के लिए, 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)
डेटा सोर्स की शीट पर लागू किया गया फ़िल्टर जोड़ता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | उस कॉलम का नाम जिस पर यह फ़िल्टर लागू करना है. |
filterCriteria | FilterCriteria | लागू किए जाने वाले फ़िल्टर मानदंड. |
वापसी का टिकट
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)
चुने गए कॉलम की चौड़ाई का साइज़ अपने-आप बदल देता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | कॉलम का नाम. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए यह डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(columnNames)
तय किए गए कॉलम की चौड़ाई का साइज़ अपने-आप बदल देता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnNames | String[] | अपडेट किए जाने वाले कॉलम के नामों की सूची. |
वापसी का टिकट
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)
चुने गए कॉलम की चौड़ाई दिखाता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | कॉलम का नाम. |
वापसी का टिकट
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)
दिए गए कॉलम के नाम के लिए, डेटा सोर्स शीट की सभी वैल्यू दिखाता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | जिस डेटा सोर्स कॉलम के लिए वैल्यू फ़ेच करनी हैं उसका नाम. |
वापसी का टिकट
Object[]
— वैल्यू की एक डाइमेंशन वाली कैटगरी.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(columnName, startRow, numRows)
दिए गए कॉलम के नाम से, डेटा सोर्स शीट की सभी वैल्यू दिखाता है
शुरुआती पंक्ति (1 के आधार पर) और दिए गए numRows
तक.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | जिस डेटा सोर्स कॉलम के लिए वैल्यू फ़ेच करनी हैं उसका नाम. |
startRow | Integer | पंक्ति की वह जगह जिससे वैल्यू फ़ेच करनी हैं. |
numRows | Integer | फ़ेच की जाने वाली पंक्तियों की संख्या. |
वापसी का टिकट
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)
डेटा सोर्स के शीट कॉलम पर लगाए गए सभी फ़िल्टर हटा देता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | उस कॉलम का नाम जिससे फ़िल्टर हटाने हैं. |
वापसी का टिकट
DataSourceSheet
— तरीके की चेन के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeSortSpec(columnName)
डेटा सोर्स शीट में किसी कॉलम पर, क्रम से लगाने की खास जानकारी हटा देता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | कॉलम का नाम. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnName, width)
चुने गए कॉलम की चौड़ाई सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | कॉलम का नाम. |
width | Integer | कॉलम के लिए नई चौड़ाई. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए यह डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(columnNames, width)
तय किए गए कॉलम की चौड़ाई सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnNames | String[] | अपडेट किए जाने वाले कॉलम के नामों की सूची. |
width | Integer | कॉलम की नई चौड़ाई. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए यह डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, ascending)
डेटा सोर्स की शीट में किसी कॉलम पर, क्रम से लगाने की खास जानकारी सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | क्रम से लगाने के लिए कॉलम का नाम. |
ascending | Boolean | अगर true , तो कॉलम को बढ़ते क्रम में लगाएं; अगर false है, तो क्रम से लगाएं
कॉलम को घटते क्रम में लगाएं. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSortSpec(columnName, sortOrder)
डेटा सोर्स की शीट में किसी कॉलम पर, क्रम से लगाने की खास जानकारी सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
columnName | String | क्रम से लगाने के लिए कॉलम का नाम. |
sortOrder | SortOrder | क्रम से लगाने का क्रम. |
वापसी का टिकट
DataSourceSheet
— चेन बनाने के लिए डेटा सोर्स शीट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. दिए गए सेकंड में, समय खत्म हो जाता है. अगर समय खत्म होने पर निष्पादन पूरा नहीं होता है, तो अपवाद देता है, लेकिन डेटा प्रोसेस करना.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
timeoutInSeconds | Integer | डेटा प्रोसेस होने तक इंतज़ार का समय (सेकंड में). ज़्यादा से ज़्यादा 300 वर्ण हो सकते हैं सेकंड. |
वापसी का टिकट
DataExecutionStatus
— डेटा प्रोसेस होने की स्थिति.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets