Class DataSourceFormula

DataSourceFormula

मौजूदा डेटा सोर्स के फ़ॉर्मूले ऐक्सेस करना और उनमें बदलाव करना. डेटा सोर्स का नया फ़ॉर्मूला बनाने के लिए, Range.setFormula(formula) का इस्तेमाल करें.

इस क्लास का इस्तेमाल सिर्फ़ उस डेटा के साथ करें जो BigQuery डेटाबेस से कनेक्ट किया गया हो.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
cancelDataRefresh()DataSourceFormulaअगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश हो रहा है, तो यह फ़ंक्शन उसे रद्द कर देता है.
forceRefreshData()DataSourceFormulaयह ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही उसकी मौजूदा स्थिति कुछ भी हो.
getAnchorCell()Rangeयह फ़ंक्शन, उस सेल का Range दिखाता है जहां यह डेटा सोर्स फ़ॉर्मूला ऐंकर किया गया है.
getDataSource()DataSourceइस ऑब्जेक्ट से लिंक किए गए डेटा सोर्स को दिखाता है.
getDisplayValue()Stringयह फ़ंक्शन, डेटा सोर्स के फ़ॉर्मूले की डिसप्ले वैल्यू दिखाता है.
getFormula()Stringइस डेटा सोर्स फ़ॉर्मूले के लिए फ़ॉर्मूला दिखाता है.
getStatus()DataExecutionStatusइस फ़ंक्शन से, ऑब्जेक्ट के डेटा एक्ज़ीक्यूशन की स्थिति मिलती है.
refreshData()DataSourceFormulaइस कुकी का इस्तेमाल ऑब्जेक्ट के डेटा को रीफ़्रेश करने के लिए किया जाता है.
setFormula(formula)DataSourceFormulaफ़ॉर्मूला अपडेट करता है.
waitForCompletion(timeoutInSeconds)DataExecutionStatusयह फ़ंक्शन, मौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. साथ ही, तय किए गए सेकंड के बाद टाइम आउट हो जाता है.

ज़्यादा जानकारी वाला दस्तावेज़

cancelDataRefresh()

अगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश हो रहा है, तो यह फ़ंक्शन उसे रद्द कर देता है.

इस उदाहरण में, फ़ॉर्मूला रीफ़्रेश करने की प्रोसेस को रद्द करने का तरीका बताया गया है. 

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

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

वापसी का टिकट

DataSourceFormula — डेटा ऑब्जेक्ट.

अनुमति देना

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

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

forceRefreshData()

यह ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही उसकी मौजूदा स्थिति कुछ भी हो. ज़्यादा जानकारी के लिए, refreshData() देखें. अगर आपको इस ऑब्जेक्ट को रीफ़्रेश करने की मौजूदा प्रोसेस को रद्द करना है, तो cancelDataRefresh() देखें.

अगर डेटा सोर्स टाइप चालू नहीं है, तो यह फ़ंक्शन एक अपवाद दिखाता है. किसी खास तरह के डेटा सोर्स का डेटा प्रोसेस करने के लिए, 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)

फ़ॉर्मूला अपडेट करता है.

पैरामीटर

नामटाइपब्यौरा
formulaStringनया फ़ॉर्मूला.

वापसी का टिकट

DataSourceFormula — चेनिंग के लिए डेटा सोर्स का फ़ॉर्मूला.

अनुमति देना

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

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

waitForCompletion(timeoutInSeconds)

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

पैरामीटर

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

वापसी का टिकट

DataExecutionStatus — डेटा प्रोसेस करने की स्थिति.

अनुमति देना

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

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