Class DataSourceChart

DataSourceChart

किसी मौजूदा डेटा सोर्स चार्ट को ऐक्सेस करना और उसमें बदलाव करना.

इस क्लास का इस्तेमाल सिर्फ़ BigQuery डेटाबेस से जुड़े डेटा के साथ करें.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
cancelDataRefresh()DataSourceChartअगर इस ऑब्जेक्ट से जुड़ा डेटा रीफ़्रेश फ़िलहाल चल रहा है, तो उसे रद्द कर देता है.
forceRefreshData()DataSourceChartमौजूदा स्थिति पर ध्यान दिए बिना, इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है.
getDataSource()DataSourceउस डेटा सोर्स को फ़ेच करता है जिससे ऑब्जेक्ट लिंक किया गया है.
getStatus()DataExecutionStatusइससे ऑब्जेक्ट का डेटा प्रोसेस होने के स्टेटस की जानकारी मिलती है.
refreshData()DataSourceChartऑब्जेक्ट का डेटा रीफ़्रेश करता है.
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() तरीके का इस्तेमाल करें टाइप करें.

वापसी का टिकट

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

अनुमति देना

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

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

forceRefreshData()

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

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

वापसी का टिकट

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

अनुमति देना

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

  • 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

getStatus()

इससे ऑब्जेक्ट का डेटा प्रोसेस होने के स्टेटस की जानकारी मिलती है.

वापसी का टिकट

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

अनुमति देना

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

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

refreshData()

ऑब्जेक्ट का डेटा रीफ़्रेश करता है.

अगर अभी error स्थिति में है, तो अपवाद देता है. स्पेसिफ़िकेशन अपडेट करने के लिए, DataSource#updateSpec() का इस्तेमाल करें. तरीका है डेटा सोर्स में अनचाहे बदलावों को रोकने के लिए, forceRefreshData() से ज़्यादा प्राथमिकता दी जाती है.

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

वापसी का टिकट

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

अनुमति देना

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

  • 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