Class DataSourcePivotTable

DataSourcePivotTable

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

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

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addColumnGroup(columnName)PivotGroupयह फ़ंक्शन, तय किए गए डेटा सोर्स कॉलम के आधार पर नया पिवट कॉलम ग्रुप जोड़ता है.
addFilter(columnName, filterCriteria)PivotFilterयह फ़ंक्शन, तय की गई फ़िल्टर की शर्तों के साथ-साथ, तय किए गए डेटा सोर्स कॉलम के आधार पर नया फ़िल्टर जोड़ता है.
addPivotValue(columnName)PivotValueयह फ़ंक्शन, डेटा सोर्स के चुने गए कॉलम के आधार पर नई पिवट वैल्यू जोड़ता है. इसमें किसी भी तरह का 'खास जानकारी' फ़ंक्शन इस्तेमाल नहीं किया जाता.
addPivotValue(columnName, summarizeFunction)PivotValueयह फ़ंक्शन, बताए गए डेटा सोर्स कॉलम के आधार पर नई पिवट वैल्यू जोड़ता है. इसके लिए, बताए गए summarize फ़ंक्शन का इस्तेमाल किया जाता है.
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.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const 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)

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

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

पैरामीटर

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

वापसी का टिकट

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