मौजूदा डेटा सोर्स को ऐक्सेस करना और उसमें बदलाव करना. नए डेटा सोर्स के साथ डेटा सोर्स की टेबल बनाने के लिए, 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)
फ़ॉर्मूला के आधार पर तैयार किया गया कॉलम बनाता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
name | String | आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए कॉलम का नाम. |
formula | String | फ़ॉर्मूला के आधार पर तैयार किए गए कॉलम का फ़ॉर्मूला. |
रिटर्न
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)
डेटा सोर्स में वह कॉलम दिखाता है जो कॉलम के नाम से मेल खाता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
columnName | String | आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए कॉलम का नाम, जिसे आपको कैलकुलेट करना है. |
रिटर्न
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() तरीके का इस्तेमाल करें.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
spec | DataSourceSpec | अपडेट किए जाने वाले डेटा सोर्स की खास बातें. |
रिटर्न
DataSource — डेटा सोर्स.
अनुमति
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा दायरे के साथ अनुमति देना ज़रूरी होता है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
updateSpec(spec, refreshAllLinkedObjects)
डेटा सोर्स की खास बातों को अपडेट करता है और लिंक किए गए data
source sheets को नई जानकारी से रीफ़्रेश करता है.
डेटा सोर्स का टाइप चालू न होने पर, अपवाद माना जाता है. किसी खास तरह के डेटा सोर्स को डेटा प्रोसेस करने की सुविधा चालू करने के लिए, SpreadsheetApp#enable...Execution() तरीके का इस्तेमाल करें.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
spec | DataSourceSpec | अपडेट किए जाने वाले डेटा सोर्स की खास बातें. |
refreshAllLinkedObjects | Boolean | अगर true, तो इस डेटा सोर्स से लिंक किए गए सभी डेटा सोर्स के ऑब्जेक्ट
रीफ़्रेश कर देता है. |
रिटर्न
DataSource — डेटा सोर्स.
अनुमति
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा दायरे के साथ अनुमति देना ज़रूरी होता है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
यह तब तक इंतज़ार करता है, जब तक लिंक किए गए डेटा सोर्स ऑब्जेक्ट के सभी मौजूदा प्रोसेस पूरी नहीं हो जाते. साथ ही, दिए गए सेकंड के बाद टाइम आउट हो जाता है. अगर टाइम आउट पर एक्ज़ीक्यूशन पूरा नहीं होता है, लेकिन डेटा प्रोसेस होने की प्रोसेस को रद्द नहीं करता है, तो अपवाद देता है.
पैरामीटर
| नाम | टाइप | ब्यौरा |
|---|---|---|
timeoutInSeconds | Integer | डेटा प्रोसेस होने तक इंतज़ार करने का समय (सेकंड में). यह अवधि ज़्यादा से ज़्यादा 300 सेकंड हो सकती है. |
अनुमति
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा दायरे के साथ अनुमति देना ज़रूरी होता है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets