Class 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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

---

waitForCompletion(timeoutInSeconds)

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

पैरामीटर

नाम	टाइप	ब्यौरा
timeoutInSeconds	Integer	डेटा प्रोसेस होने में लगने वाला समय, सेकंड में. यह अवधि ज़्यादा से ज़्यादा 300 सेकंड हो सकती है.

वापसी का टिकट

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

अनुमति देना

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

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