Class DataSourceSheet

DataSourceSheet

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

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addFilter(columnName, filterCriteria)DataSourceSheetडेटा सोर्स शीट पर लागू किया गया फ़िल्टर जोड़ता है.
asSheet()Sheetडेटा सोर्स शीट को सामान्य शीट ऑब्जेक्ट के तौर पर दिखाता है.
autoResizeColumn(columnName)DataSourceSheetतय किए गए कॉलम की चौड़ाई का साइज़ अपने-आप बदल देता है.
autoResizeColumns(columnNames)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)

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

पैरामीटर

नामTypeब्यौरा
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)

तय किए गए कॉलम की चौड़ाई का साइज़ अपने-आप बदल देता है.

पैरामीटर

नामTypeब्यौरा
columnNameStringकॉलम का नाम.

रिटर्न

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

अनुमति देना

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

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

autoResizeColumns(columnNames)

तय किए गए कॉलम की चौड़ाई का साइज़ अपने-आप बदल देता है.

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

forceRefreshData()

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

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

रिटर्न

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

अनुमति देना

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

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

getColumnWidth(columnName)

तय किए गए कॉलम की चौड़ाई दिखाता है.

पैरामीटर

नामTypeब्यौरा
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)

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

पैरामीटर

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

रिटर्न

Object[] — वैल्यू का एक डाइमेंशन वाला कलेक्शन.

अनुमति देना

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

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

getSheetValues(columnName, startRow, numRows)

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

पैरामीटर

नामTypeब्यौरा
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)

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

removeSortSpec(columnName)

डेटा सोर्स शीट में किसी कॉलम पर क्रम से लगाने की खास जानकारी को हटाता है.

पैरामीटर

नामTypeब्यौरा
columnNameStringकॉलम का नाम.

रिटर्न

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

अनुमति देना

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

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

setColumnWidth(columnName, width)

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

पैरामीटर

नामTypeब्यौरा
columnNameStringकॉलम का नाम.
widthIntegerकॉलम के लिए नई चौड़ाई.

रिटर्न

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

अनुमति देना

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

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

setColumnWidths(columnNames, width)

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

setSortSpec(columnName, ascending)

डेटा सोर्स शीट में किसी कॉलम पर क्रम से लगाने का निर्देश सेट करता है.

पैरामीटर

नामTypeब्यौरा
columnNameStringक्रम से लगाए जाने वाले कॉलम का नाम.
ascendingBooleanअगर true है, तो कॉलम को बढ़ते क्रम में लगाएं. अगर false है, तो कॉलम को घटते क्रम में लगाएं.

रिटर्न

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

अनुमति देना

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

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

setSortSpec(columnName, sortOrder)

डेटा सोर्स शीट में किसी कॉलम पर क्रम से लगाने का निर्देश सेट करता है.

पैरामीटर

नामTypeब्यौरा
columnNameStringक्रम से लगाए जाने वाले कॉलम का नाम.
sortOrderSortOrderक्रम से लगाने का क्रम.

रिटर्न

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

अनुमति देना

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

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

waitForCompletion(timeoutInSeconds)

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

पैरामीटर

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

रिटर्न

DataExecutionStatus — डेटा एक्ज़ीक्यूशन का स्टेटस.

अनुमति देना

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

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