Class DataSource

DataSource

मौजूदा डेटा सोर्स को ऐक्सेस करना और उसमें बदलाव करना. नए डेटा सोर्स के साथ डेटा सोर्स की टेबल बनाने के लिए, 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ब्यौरा
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)

यह फ़ंक्शन कॉलम के नाम से मैच होने वाले डेटा सोर्स में, कैलकुलेटेड कॉलम को कैलकुलेट करता है.

पैरामीटर

नामTypeब्यौरा
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() तरीके का इस्तेमाल करें.

पैरामीटर

नामTypeब्यौरा
specDataSourceSpecउस डेटा सोर्स की खास बातें जिसके साथ अपडेट करना है.

रिटर्न

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

अनुमति देना

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

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

updateSpec(spec, refreshAllLinkedObjects)

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

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

पैरामीटर

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

रिटर्न

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

अनुमति देना

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

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

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

पैरामीटर

नामTypeब्यौरा
timeoutInSecondsIntegerडेटा निष्पादन के लिए इंतज़ार करने का समय, सेकंड में. यह ज़्यादा से ज़्यादा 300 सेकंड का हो सकता है.

अनुमति देना

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

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