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)

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

पैरामीटर

नाम	टाइप	ब्यौरा
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.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var 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)

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

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