Class 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)

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

पैरामीटर

नाम	टाइप	ब्यौरा
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