इस गाइड में, स्प्रेडशीट में पिवट टेबल बनाने के लिए, Google Sheets API का इस्तेमाल करने का तरीका और इसकी वजह बताई गई है.
पिवट टेबल क्या होती है?
पिवट टेबल की मदद से, स्प्रेडशीट में मौजूद डेटा की खास जानकारी देखी जा सकती है. यह डेटा को अपने-आप एग्रीगेट, क्रम से लगाती है, गिनती करती है या उसका औसत निकालती है. साथ ही, खास जानकारी वाले नतीजों को नई टेबल में दिखाती है. पिवट टेबल, सोर्स डेटासेट के लिए क्वेरी की तरह काम करती है. यह सोर्स डेटा, स्प्रेडशीट में किसी दूसरी जगह मौजूद होता है. पिवट टेबल, डेटा का प्रोसेस किया गया व्यू दिखाती है.
उदाहरण के लिए, बिक्री का यह डेटासेट देखें:
| A | B | C | D | E | F | G | |
| 1 | आइटम की कैटगरी | मॉडल नंबर | लागत | मात्रा | क्षेत्र | सेल्सपर्सन | भेजने की तारीख |
| 2 | पहिया | W-24 | 20.50 डॉलर | 4 | पश्चिम | Beth | 1/3/2016 |
| 3 | दरवाज़ा | D-01X | 15.00 डॉलर | 2 | दक्षिण | Amir | 15/3/2016 |
| 4 | इंजन | ENG-0134 | 100.00 डॉलर | 1 | उत्तर | Carmen | 20/3/2016 |
| 5 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 8 | पूर्व | Hannah | 12/3/2016 |
| 6 | पैनल | P-034 | 6.00 डॉलर | 4 | उत्तर | Devyn | 2/4/2016 |
| 7 | पैनल | P-052 | 11.50 डॉलर | 7 | पूर्व | Erik | 16/5/2016 |
| 8 | पहिया | W-24 | 20.50 डॉलर | 11 | दक्षिण | Sheldon | 30/4/2016 |
| 9 | इंजन | ENG-0161 | 330.00 डॉलर | 2 | उत्तर | Jessie | 2/7/2016 |
| 10 | दरवाज़ा | D-01Y | 29.00 डॉलर | 6 | पश्चिम | Armando | 13/3/2016 |
| 11 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 9 | दक्षिण | Yuliana | 27/2/2016 |
| 12 | पैनल | P-102 | 3.00 डॉलर | 15 | पश्चिम | Carmen | 18/4/2016 |
| 13 | पैनल | P-105 | 8.25 डॉलर | 13 | पश्चिम | Jessie | 20/6/2016 |
| 14 | इंजन | ENG-0211 | 283.00 डॉलर | 1 | उत्तर | Amir | 21/6/2016 |
| 15 | दरवाज़ा | D-01X | 15.00 डॉलर | 2 | पश्चिम | Armando | 3/7/2016 |
| 16 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 6 | दक्षिण | Carmen | 15/7/2016 |
| 17 | पहिया | W-25 | 20.00 डॉलर | 8 | दक्षिण | Hannah | 2/5/2016 |
| 18 | पहिया | W-11 | 29.00 डॉलर | 13 | पूर्व | Erik | 19/5/2016 |
| 19 | दरवाज़ा | D-05 | 17.70 डॉलर | 7 | पश्चिम | Beth | 28/6/2016 |
| 20 | फ़्रेम | FR-0B1 | 34.00 डॉलर | 8 | उत्तर | Sheldon | 30/3/2016 |
पिवट टेबल का इस्तेमाल करके, एक रिपोर्ट बनाई जा सकती है. इसमें यह दिखाया जा सकता है कि हर क्षेत्र में हर मॉडल नंबर के कितने आइटम बेचे गए:

इस पिवट टेबल को जनरेट करने के लिए इस्तेमाल किया गया सोर्स कोड देखने के लिए, नीचे दिया गया उदाहरण सेक्शन देखें.
किसी स्प्रेडशीट में पिवट टेबल जोड़ने के बाद, उपयोगकर्ता Sheets के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, खास जानकारी के स्ट्रक्चर और उसमें मौजूद जानकारी को इंटरैक्टिव तरीके से बदल सकते हैं.
पिवट टेबल के साथ काम करना
पिवट टेबल की परिभाषा, शीट में किसी एक सेल से जुड़ी होती है. हालांकि, यह रेंडर होने पर ऊंचाई और चौड़ाई, दोनों में कई सेल में दिखती है, लेकिन प्रोग्राम के हिसाब से यह किसी एक सेल के कोऑर्डिनेट पर मौजूद होती है. यह सेल, रेंडर की गई पिवट टेबल का सबसे ऊपर वाला बाएं कोना बन जाती है. इसकी हॉरिज़ॉन्टल और वर्टिकल सीमा, इसकी परिभाषा से तय होती है.
पिवट टेबल जोड़ना
पिवट टेबल जोड़ने के लिए, batchUpdate तरीके का इस्तेमाल करें. इसके लिए, updateCells अनुरोध सबमिट करें. इस अनुरोध का इस्तेमाल करके, किसी सेल के कॉन्टेंट के तौर पर a PivotTable की परिभाषा सबमिट करें. जैसे, यहां दिखाया गया है:
{
"updateCells": {
"rows": {
"values": [
{
"pivotTable": "MyPivotTable"
}
],
"start": {
"sheetId": "sheetId",
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
}
}
इससे, बताई गई शीट पर MyPivotTable के तौर पर पिवट टेबल जुड़ जाती है. इसका सबसे ऊपर वाला बाएं कोना, सेल A1 पर होता है. (पिवट टेबल की ऊंचाई और चौड़ाई डाइनैमिक होती है. आपको सिर्फ़ ओरिजन की जानकारी देनी होती है.)
- सोर्स डेटा की रेंज
- एक या उससे ज़्यादा फ़ील्ड. इनका डेटा, पिवट टेबल की पंक्तियां बनाएगा
- एक या उससे ज़्यादा फ़ील्ड. इनका डेटा, पिवट टेबल के कॉलम बनाएगा
- फ़िल्टर करने और एग्रीगेशन के मानदंड
- पिवट टेबल का लेआउट
पिवट टेबल में बदलाव करना और उसे मिटाना
पिवट टेबल में बदलाव करने या उसे मिटाने के लिए, कोई साफ़ तौर पर अनुरोध नहीं किया जा सकता. इसके बजाय, अलग-अलग सेल कॉन्टेंट के साथ an updateCells अनुरोध का इस्तेमाल करें:
- PivotTable
- पिवट टेबल मिटाने के लिए, सेल को खाली वैल्यू से अपडेट करें. उदाहरण के लिए, पिवट टेबल मिटाने का सैंपल देखें.
इस्तेमाल के उदाहरण
पिवट टेबल का इस्तेमाल कई अलग-अलग तरीकों से किया जा सकता है. जैसे, आंकड़ों का विश्लेषण, ईआरपी ऐप्लिकेशन, वित्तीय रिपोर्टिंग वगैरह. पिवट टेबल के इस्तेमाल के कुछ उदाहरण यहां दिए गए हैं:
- क्षेत्र और तिमाही के हिसाब से कुल बिक्री
- टाइटल और जगह के हिसाब से औसत सैलरी
- प्रॉडक्ट और दिन के समय के हिसाब से, हुई घटनाओं की संख्या
पिवट टेबल का इस्तेमाल कई तरीकों से किया जा सकता है. साथ ही, इन्हें प्रोग्राम के ज़रिए जनरेट करने की सुविधा भी उपलब्ध है. ऐसी पिवट टेबल जनरेट की जा सकती हैं जिनमें इंटरैक्टिव तरीके से एक्सप्लोर करने की सुविधा हो. हालांकि, इन्हें खास स्थितियों के हिसाब से बनाया जाता है. उदाहरण के लिए:
- पिछले 24 घंटों में हुई घटनाओं का डेटा एक्सप्लोर करना
- चुने गए खाते से जुड़े एग्रीगेट किए गए डेटा को देखना या उसका विश्लेषण करना
- मौजूदा उपयोगकर्ता के इलाकों के लिए बिक्री का डेटा देखना
उदाहरण
इस उदाहरण में, डेटासेट से पिवट टेबल बनाई गई है. इससे, इस पेज की शुरुआत में दिखाई गई "क्षेत्र के हिसाब से मॉडल नंबर" रिपोर्ट जनरेट होती है. ज़्यादा उदाहरणों के लिए, पिवट टेबल का सैंपल पेज देखें.