मौजूदा डेटा सोर्स पिवट टेबल को ऐक्सेस करना और उसमें बदलाव करना. डेटा सोर्स में मौजूद नई पिवट टेबल बनाने के लिए, इसका इस्तेमाल करें
Range.createDataSourcePivotTable(dataSource)
.
इस क्लास का इस्तेमाल सिर्फ़ डेटाबेस से जुड़े डेटा के साथ करें.
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
addColumnGroup(columnName) | PivotGroup | तय किए गए डेटा सोर्स कॉलम के आधार पर एक नया पिवट कॉलम ग्रुप जोड़ता है. |
addFilter(columnName, filterCriteria) | PivotFilter | तय किए गए डेटा सोर्स कॉलम के आधार पर, फ़िल्टर करने की शर्तों के साथ एक नया फ़िल्टर जोड़ता है. |
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, summarizeFunction)
यह विकल्प, दिए गए डेटा सोर्स कॉलम के आधार पर, खास जानकारी के साथ एक नई पिवट वैल्यू जोड़ता है फ़ंक्शन का इस्तेमाल करना होगा.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
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