Class DataSource

DataSource

मौजूदा डेटा सोर्स ऐक्सेस करना और उसमें बदलाव करना. नए डेटा सोर्स के साथ डेटा सोर्स की टेबल बनाने के लिए, देखें DataSourceTable.

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
cancelAllLinkedDataSourceObjectRefreshes()voidइस डेटा सोर्स से लिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी इस समय चल रहे रीफ़्रेश रद्द कर देता है.
createCalculatedColumn(name, formula)DataSourceColumnकैलकुलेटेड कॉलम बनाता है.
createDataSourcePivotTableOnNewSheet()DataSourcePivotTableयह डेटा सोर्स से नई शीट की पहली सेल में, डेटा सोर्स के लिए पिवट टेबल बनाता है.
createDataSourceTableOnNewSheet()DataSourceTableनई शीट की पहली सेल में, इस डेटा सोर्स का इस्तेमाल करके डेटा सोर्स टेबल बनाता है.
getCalculatedColumnByName(columnName)DataSourceColumnडेटा सोर्स में, कॉलम के नाम से मैच होने वाला वह कॉलम दिखाता है जो आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किया गया है.
getCalculatedColumns()DataSourceColumn[]डेटा सोर्स में, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी कॉलम दिखाता है.
getColumns()DataSourceColumn[]डेटा सोर्स में सभी कॉलम दिखाता है.
getDataSourceSheets()DataSourceSheet[]इस डेटा सोर्स से जुड़ी डेटा सोर्स शीट दिखाता है.
getSpec()DataSourceSpecइससे डेटा सोर्स की जानकारी मिलती है.
refreshAllLinkedDataSourceObjects()voidडेटा सोर्स से लिंक किए गए सभी डेटा सोर्स ऑब्जेक्ट रीफ़्रेश करता है.
updateSpec(spec)DataSourceयह डेटा सोर्स की जानकारी को अपडेट करता है और इससे लिंक किए गए डेटा सोर्स ऑब्जेक्ट को रीफ़्रेश करता है डेटा सोर्स में नई जानकारी जोड़ें.
updateSpec(spec, refreshAllLinkedObjects)DataSourceयह डेटा सोर्स की जानकारी को अपडेट करता है. साथ ही, लिंक किए गए data source sheets को नई जानकारी के साथ रीफ़्रेश करता है.
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidलिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी मौजूदा एक्ज़िक्यूशन पूरा होने तक इंतज़ार करता है. समय खत्म हो जाएगा सेकंड की संख्या के बाद.

विस्तृत दस्तावेज़

cancelAllLinkedDataSourceObjectRefreshes()

इस डेटा सोर्स से लिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी इस समय चल रहे रीफ़्रेश रद्द कर देता है.

इस उदाहरण में डेटा सोर्स के सभी रीफ़्रेश रद्द करने का तरीका बताया गया है.

SpreadsheetApp.enableBigQueryExecution();
const dataSource = spreadsheet.getDataSources()[0];
dataSource.cancelAllLinkedDataSourceObjectRefreshes();

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

अनुमति देना

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

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

createCalculatedColumn(name, formula)

कैलकुलेटेड कॉलम बनाता है.

पैरामीटर

नामटाइपब्यौरा
nameStringकैलकुलेटेड कॉलम का नाम.
formulaStringकैलकुलेटेड कॉलम का फ़ॉर्मूला.

वापसी का टिकट

DataSourceColumn — आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किया गया नया कॉलम.

अनुमति देना

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

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

createDataSourcePivotTableOnNewSheet()

यह डेटा सोर्स से नई शीट की पहली सेल में, डेटा सोर्स के लिए पिवट टेबल बनाता है. बतौर साइड इफ़ेक्ट की वजह से, नई शीट ऐक्टिव शीट बन जाती है.

वापसी का टिकट

DataSourcePivotTable — नई बनाई गई डेटा सोर्स पिवट टेबल.

अनुमति देना

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

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

createDataSourceTableOnNewSheet()

नई शीट की पहली सेल में, इस डेटा सोर्स का इस्तेमाल करके डेटा सोर्स टेबल बनाता है. एक साइड के तौर पर प्रभाव, नई शीट को सक्रिय शीट बनाता है.

वापसी का टिकट

DataSourceTable — नई डेटा सोर्स टेबल बनाई गई.

अनुमति देना

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

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

getCalculatedColumnByName(columnName)

डेटा सोर्स में, कॉलम के नाम से मेल खाने वाला कॉलम दिखाता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringआपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए कॉलम का नाम.

वापसी का टिकट

DataSourceColumn — कॉलम के नाम से मेल खाने वाला कैलकुलेटेड कॉलम या null, अगर ऐसा कोई कॉलम नहीं है कॉलम तैयार किया गया है.

अनुमति देना

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

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

getCalculatedColumns()

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

वापसी का टिकट

DataSourceColumn[] — डेटा सोर्स में, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए सभी कॉलम का कलेक्शन.

अनुमति देना

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

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

getColumns()

डेटा सोर्स में सभी कॉलम दिखाता है.

वापसी का टिकट

DataSourceColumn[] — डेटा सोर्स में मौजूद सभी DataSourceColumn का कलेक्शन.

अनुमति देना

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

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

getDataSourceSheets()

इस डेटा सोर्स से जुड़ी डेटा सोर्स शीट दिखाता है.

वापसी का टिकट

DataSourceSheet[] — डेटा सोर्स शीट का कलेक्शन.

अनुमति देना

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

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

getSpec()

इससे डेटा सोर्स की जानकारी मिलती है.

वापसी का टिकट

DataSourceSpec — डेटा सोर्स की जानकारी.

अनुमति देना

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

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

refreshAllLinkedDataSourceObjects()

डेटा सोर्स से लिंक किए गए सभी डेटा सोर्स ऑब्जेक्ट रीफ़्रेश करता है.

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

अनुमति देना

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

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

updateSpec(spec)

यह डेटा सोर्स की जानकारी को अपडेट करता है और इससे लिंक किए गए डेटा सोर्स ऑब्जेक्ट को रीफ़्रेश करता है डेटा सोर्स में नई जानकारी जोड़ें.

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

पैरामीटर

नामटाइपब्यौरा
specDataSourceSpecडेटा सोर्स की वे जानकारी जिन्हें अपडेट करना है.

वापसी का टिकट

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

अनुमति देना

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

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

updateSpec(spec, refreshAllLinkedObjects)

यह डेटा सोर्स की जानकारी को अपडेट करता है. साथ ही, लिंक किए गए data source sheets को नई जानकारी के साथ रीफ़्रेश करता है.

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

पैरामीटर

नामटाइपब्यौरा
specDataSourceSpecडेटा सोर्स की वे जानकारी जिन्हें अपडेट करना है.
refreshAllLinkedObjectsBooleanअगर true, तो डेटा सोर्स के सभी ऑब्जेक्ट भी रीफ़्रेश किए जाते हैं लिंक किया गया है.

वापसी का टिकट

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

अनुमति देना

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

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

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

पैरामीटर

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

अनुमति देना

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

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