मौजूदा डेटा सोर्स के फ़ॉर्मूले ऐक्सेस करें और उनमें बदलाव करें. नया डेटा सोर्स फ़ॉर्मूला बनाने के लिए, Range.setFormula(formula)
का इस्तेमाल करें.
इस क्लास का इस्तेमाल सिर्फ़ ऐसे डेटा के साथ करें जो डेटाबेस से कनेक्ट हो.
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
forceRefreshData() | DataSourceFormula | इस ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही मौजूदा स्थिति कुछ भी हो. |
getAnchorCell() | Range | वह Range दिखाता है जो उस सेल को दिखाता है जहां यह डेटा सोर्स फ़ॉर्मूला ऐंकर किया गया है. |
getDataSource() | DataSource | उस डेटा सोर्स की जानकारी देता है जिससे ऑब्जेक्ट लिंक होता है. |
getDisplayValue() | String | डेटा सोर्स के फ़ॉर्मूला की डिसप्ले वैल्यू दिखाता है. |
getFormula() | String | इस डेटा सोर्स फ़ॉर्मूला के लिए फ़ॉर्मूला दिखाता है. |
getStatus() | DataExecutionStatus | इससे, ऑब्जेक्ट के डेटा एक्ज़ीक्यूशन की स्थिति की जानकारी मिलती है. |
refreshData() | DataSourceFormula | ऑब्जेक्ट का डेटा रीफ़्रेश करता है. |
setFormula(formula) | DataSourceFormula | फ़ॉर्मूला को अपडेट करता है. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | मौजूदा एक्ज़ीक्यूशन पूरा होने का इंतज़ार करता है और दी गई अवधि के बाद टाइम आउट करता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
forceRefreshData()
इस ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही मौजूदा स्थिति कुछ भी हो. ज़्यादा जानकारी के लिए, refreshData()
पर जाएं.
अगर डेटा सोर्स का टाइप चालू नहीं है, तो यह एक अपवाद है. किसी खास तरह के डेटा सोर्स का डेटा एक्ज़ीक्यूशन करने के लिए, SpreadsheetApp#enable...Execution()
तरीके का इस्तेमाल करें.
रिटर्न
DataSourceFormula
— डेटा ऑब्जेक्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
वह Range
दिखाता है जो उस सेल को दिखाता है जहां यह डेटा सोर्स फ़ॉर्मूला ऐंकर किया गया है.
रिटर्न
Range
— ऐंकर सेल.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
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
getDisplayValue()
डेटा सोर्स के फ़ॉर्मूला की डिसप्ले वैल्यू दिखाता है.
रिटर्न
String
— डिसप्ले वैल्यू.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
इस डेटा सोर्स फ़ॉर्मूला के लिए फ़ॉर्मूला दिखाता है.
रिटर्न
String
— फ़ॉर्मूला.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
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()
तरीके का इस्तेमाल करें.
रिटर्न
DataSourceFormula
— डेटा ऑब्जेक्ट.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
फ़ॉर्मूला को अपडेट करता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
formula | String | नया फ़ॉर्मूला. |
रिटर्न
DataSourceFormula
— चेन बनाने के लिए, डेटा सोर्स का फ़ॉर्मूला.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
मौजूदा एक्ज़ीक्यूशन पूरा होने का इंतज़ार करता है और दी गई अवधि के बाद टाइम आउट करता है. अगर टाइम आउट पर कार्रवाई पूरी नहीं होती है, तो यह एक अपवाद है, लेकिन इससे डेटा एक्ज़ीक्यूशन रद्द नहीं होता है.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
timeoutInSeconds | Integer | डेटा प्रोसेस होने तक इंतज़ार का समय (सेकंड में). यह ज़्यादा से ज़्यादा 300 सेकंड का हो सकता है. |
रिटर्न
DataExecutionStatus
— डेटा एक्ज़ीक्यूशन का स्टेटस.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets