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