मौजूदा डेटा सोर्स की पिवट टेबल को ऐक्सेस करें और उसमें बदलाव करें. डेटा सोर्स की नई पिवट टेबल बनाने के लिए, Range.createDataSourcePivotTable(dataSource) का इस्तेमाल करें.
इस क्लास का इस्तेमाल सिर्फ़ ऐसे डेटा के साथ करें जो डेटाबेस से कनेक्ट हो.
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
addColumnGroup(columnName) | PivotGroup | दिए गए डेटा सोर्स के कॉलम के आधार पर एक नया पिवट कॉलम ग्रुप जोड़ता है. |
addFilter(columnName, filterCriteria) | PivotFilter | तय किए गए डेटा सोर्स कॉलम के आधार पर, तय फ़िल्टर शर्तों के साथ एक नया फ़िल्टर जोड़ता है. |
addPivotValue(columnName, summarizeFunction) | PivotValue | खास जानकारी देने वाले फ़ंक्शन के साथ, दिए गए डेटा सोर्स कॉलम के आधार पर नई पिवट वैल्यू जोड़ता है. |
addRowGroup(columnName) | PivotGroup | दिए गए डेटा सोर्स के कॉलम के आधार पर एक नया पिवट लाइन ग्रुप जोड़ता है. |
asPivotTable() | PivotTable | डेटा सोर्स की पिवट टेबल को सामान्य पिवट टेबल ऑब्जेक्ट के तौर पर दिखाता है. |
forceRefreshData() | DataSourcePivotTable | इस ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही मौजूदा स्थिति कुछ भी हो. |
getDataSource() | DataSource | उस डेटा सोर्स की जानकारी देता है जिससे ऑब्जेक्ट लिंक होता है. |
getStatus() | DataExecutionStatus | इससे, ऑब्जेक्ट के डेटा एक्ज़ीक्यूशन की स्थिति की जानकारी मिलती है. |
refreshData() | DataSourcePivotTable | ऑब्जेक्ट का डेटा रीफ़्रेश करता है. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | मौजूदा एक्ज़ीक्यूशन पूरा होने का इंतज़ार करता है और दी गई अवधि के बाद टाइम आउट करता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
addColumnGroup(columnName)
दिए गए डेटा सोर्स के कॉलम के आधार पर एक नया पिवट कॉलम ग्रुप जोड़ता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
columnName | String | डेटा सोर्स कॉलम का नाम, जिस पर पिवट ग्रुप होता है. |
रिटर्न
PivotGroup — नया पिवट ग्रुप.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addFilter(columnName, filterCriteria)
तय किए गए डेटा सोर्स कॉलम के आधार पर, तय फ़िल्टर शर्तों के साथ एक नया फ़िल्टर जोड़ता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
columnName | String | डेटा सोर्स के कॉलम का नाम, जिस पर फ़िल्टर आधारित होता है. |
filterCriteria | FilterCriteria | फ़िल्टर में शामिल की जाने वाली शर्तें. |
रिटर्न
PivotFilter — नया फ़िल्टर.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
खास जानकारी देने वाले फ़ंक्शन के साथ, दिए गए डेटा सोर्स कॉलम के आधार पर नई पिवट वैल्यू जोड़ता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
columnName | String | डेटा सोर्स कॉलम के नाम पर आधारित पिवट वैल्यू. |
summarizeFunction | PivotTableSummarizeFunction | पिवट वैल्यू से जुड़ी खास जानकारी देने वाला फ़ंक्शन. |
रिटर्न
PivotValue — नई पिवट वैल्यू.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addRowGroup(columnName)
दिए गए डेटा सोर्स के कॉलम के आधार पर एक नया पिवट लाइन ग्रुप जोड़ता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
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
forceRefreshData()
इस ऑब्जेक्ट के डेटा को रीफ़्रेश करता है, भले ही मौजूदा स्थिति कुछ भी हो. ज़्यादा जानकारी के लिए, refreshData() पर जाएं.
अगर डेटा सोर्स का टाइप चालू नहीं है, तो यह एक अपवाद है. किसी खास तरह के डेटा सोर्स का डेटा एक्ज़ीक्यूशन करने के लिए, 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)
मौजूदा एक्ज़ीक्यूशन पूरा होने का इंतज़ार करता है और दी गई अवधि के बाद टाइम आउट करता है. अगर टाइम आउट पर कार्रवाई पूरी नहीं होती है, तो यह एक अपवाद है, लेकिन इससे डेटा एक्ज़ीक्यूशन रद्द नहीं होता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
timeoutInSeconds | Integer | डेटा प्रोसेस होने तक इंतज़ार का समय (सेकंड में). यह ज़्यादा से ज़्यादा 300 सेकंड का हो सकता है. |
रिटर्न
DataExecutionStatus — डेटा एक्ज़ीक्यूशन का स्टेटस.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets