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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

---

addFilter(columnName, filterCriteria)

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

पैरामीटर

नाम	टाइप	ब्यौरा
columnName	String	डेटा सोर्स कॉलम का नाम, जिस पर फ़िल्टर आधारित है.
filterCriteria	FilterCriteria	फ़िल्टर के लिए इस्तेमाल की जाने वाली शर्तें.

वापसी का टिकट

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 डेटा सोर्स के लिए उपलब्ध है.

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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

---

addPivotValue(columnName, summarizeFunction)

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

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

पैरामीटर

नाम	टाइप	ब्यौरा
columnName	String	डेटा सोर्स कॉलम का नाम, जिस पर पिवट वैल्यू आधारित है.
summarizeFunction	PivotTableSummarizeFunction	पिवट वैल्यू का इस्तेमाल करने वाला समरीज़ फ़ंक्शन.

वापसी का टिकट

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

अनुमति देना

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

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

---

addRowGroup(columnName)

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

पैरामीटर

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

वापसी का टिकट

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)

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

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

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