Class DataSourcePivotTable

DataSourcePivotTable

मौजूदा डेटा सोर्स की पिवट टेबल को ऐक्सेस करना और उसमें बदलाव करना. डेटा सोर्स में मौजूद नई पिवट टेबल बनाने के लिए, इसका इस्तेमाल करें Range.createDataSourcePivotTable(dataSource).

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addColumnGroup(columnName)PivotGroupतय किए गए डेटा सोर्स कॉलम के आधार पर एक नया पिवट कॉलम ग्रुप जोड़ता है.
addFilter(columnName, filterCriteria)PivotFilterतय किए गए डेटा सोर्स कॉलम के आधार पर, फ़िल्टर करने की शर्तों के साथ एक नया फ़िल्टर जोड़ता है.
addPivotValue(columnName)PivotValueयह तय किए गए डेटा सोर्स कॉलम के आधार पर, बिना किसी खास जानकारी के एक नई पिवट वैल्यू जोड़ता है फ़ंक्शन का इस्तेमाल करना होगा.
addPivotValue(columnName, summarizeFunction)PivotValueयह विकल्प, दिए गए डेटा सोर्स कॉलम के आधार पर, खास जानकारी के साथ एक नई पिवट वैल्यू जोड़ता है फ़ंक्शन का इस्तेमाल करना होगा.
addRowGroup(columnName)PivotGroupतय किए गए डेटा सोर्स कॉलम के आधार पर, पिवट लाइन का एक नया ग्रुप जोड़ता है.
asPivotTable()PivotTableडेटा सोर्स की पिवट टेबल को सामान्य पिवट टेबल ऑब्जेक्ट के तौर पर दिखाता है.
cancelDataRefresh()DataSourcePivotTableअगर यह ऑब्जेक्ट अभी चल रहा है, तो इससे जुड़ा डेटा रीफ़्रेश रद्द हो जाता है.
forceRefreshData()DataSourcePivotTableमौजूदा स्थिति पर ध्यान दिए बिना, इस ऑब्जेक्ट का डेटा रीफ़्रेश करता है.
getDataSource()DataSourceवह डेटा सोर्स दिखाता है जिससे ऑब्जेक्ट लिंक है.
getStatus()DataExecutionStatusइससे ऑब्जेक्ट का डेटा प्रोसेस होने के स्टेटस की जानकारी मिलती है.
refreshData()DataSourcePivotTableऑब्जेक्ट का डेटा रीफ़्रेश करता है.
waitForCompletion(timeoutInSeconds)DataExecutionStatusमौजूदा एक्ज़ीक्यूशन के पूरा होने तक इंतज़ार करता है. दिए गए सेकंड में, समय खत्म हो जाता है.

विस्तृत दस्तावेज़

addColumnGroup(columnName)

दिए गए डेटा सोर्स कॉलम के आधार पर, नया पिवट कॉलम ग्रुप जोड़ता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringउस डेटा सोर्स कॉलम का नाम जिस पर पिवट ग्रुप आधारित है.

वापसी का टिकट

PivotGroup — नया पिवट ग्रुप.

अनुमति देना

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

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

addFilter(columnName, filterCriteria)

तय किए गए डेटा सोर्स कॉलम के आधार पर, फ़िल्टर करने की शर्तों के साथ एक नया फ़िल्टर जोड़ता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringडेटा सोर्स कॉलम का नाम, जिस पर फ़िल्टर आधारित है.
filterCriteriaFilterCriteriaफ़िल्टर, इन शर्तों का इस्तेमाल करता है.

वापसी का टिकट

PivotFilter — नया फ़िल्टर.

अनुमति देना

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

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

addPivotValue(columnName)

यह तय किए गए डेटा सोर्स कॉलम के आधार पर, बिना किसी खास जानकारी के एक नई पिवट वैल्यू जोड़ता है फ़ंक्शन का इस्तेमाल करना होगा. सिर्फ़ Looker मेज़र के लिए.

इस कोड में, Looker मेज़रमेंट को पिवट वैल्यू के तौर पर जोड़ने का तरीका बताया गया है.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

यह तरीका सिर्फ़ Looker डेटा सोर्स के लिए उपलब्ध है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringउस डेटा सोर्स कॉलम का नाम जिसके आधार पर पिवट वैल्यू तय होती है.

वापसी का टिकट

PivotValue — नई पिवट वैल्यू.

अनुमति देना

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

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

addPivotValue(columnName, summarizeFunction)

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

Looker मेज़र के लिए पिवट वैल्यू जोड़ने के लिए, addPivotValue(columnName) का इस्तेमाल करें.

पैरामीटर

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

वापसी का टिकट

PivotValue — नई पिवट वैल्यू.

अनुमति देना

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

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

addRowGroup(columnName)

तय किए गए डेटा सोर्स कॉलम के आधार पर, पिवट लाइन का एक नया ग्रुप जोड़ता है.

पैरामीटर

नामटाइपब्यौरा
columnNameStringउस डेटा सोर्स कॉलम का नाम जिस पर पिवट ग्रुप आधारित है.

वापसी का टिकट

PivotGroup — नया पिवट ग्रुप.

अनुमति देना

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

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

asPivotTable()

यह फ़ंक्शन डेटा सोर्स में मौजूद पिवट टेबल को सामान्य पिवट टेबल ऑब्जेक्ट के तौर पर दिखाता है.

वापसी का टिकट

PivotTable — पिवट टेबल.

अनुमति देना

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

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

cancelDataRefresh()

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

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

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

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

वापसी का टिकट

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

अनुमति देना

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

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

forceRefreshData()

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

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

वापसी का टिकट

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

अनुमति देना

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

  • 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() तरीकों का इस्तेमाल करें.

वापसी का टिकट

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

अनुमति देना

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

  • 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