Class 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पिवट वैल्यू का इस्तेमाल करने वाला समरीज़ फ़ंक्शन.

वापसी का टिकट

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