Google Sheets API से, ज़रूरत के हिसाब से स्प्रेडशीट में चार्ट बनाए जा सकते हैं और उन्हें अपडेट किया जा सकता है. इस पेज पर दिए गए उदाहरणों में बताया गया है कि Sheets API की मदद से, कुछ सामान्य चार्ट कार्रवाइयां कैसे की जा सकती हैं.
ये उदाहरण, न्यूट्रल भाषा में एचटीटीपी अनुरोधों के रूप में दिखाए जाते हैं. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, बैच अपडेट को अलग-अलग भाषाओं में लागू करने का तरीका जानने के लिए, स्प्रेडशीट अपडेट करें देखें.
इन उदाहरणों में, SPREADSHEET_ID और SHEET_ID प्लेसहोल्डर से पता चलता है कि आपको आईडी कहां देने हैं. स्प्रेडशीट आईडी को स्प्रेडशीट के यूआरएल में देखा जा सकता है. spreadsheets.get तरीके का इस्तेमाल करके, शीट का आईडी पाया जा सकता है. रेंज को A1 नोटेशन का इस्तेमाल करके बताया जाता है. उदाहरण के लिए, Sheet1!A1:D5 रेंज है.
इसके अलावा, CHART_ID प्लेसहोल्डर दिए गए चार्ट का आईडी भी दिखाता है. Sheets API की मदद से चार्ट बनाते समय इस आईडी को सेट किया जा सकता है
या Sheets API को अपने लिए चार्ट जनरेट करने की अनुमति दी जा सकती है. spreadsheets.get तरीके से आपको मौजूदा चार्ट के आईडी मिल सकते हैं.
आखिर में, SOURCE_SHEET_ID प्लेसहोल्डर आपकी शीट को सोर्स डेटा के साथ दिखाता है. इन उदाहरणों में, यह टेबल चार्ट सोर्स का डेटा में दी गई है.
चार्ट सोर्स डेटा
इन उदाहरणों के लिए, मान लें कि इस्तेमाल की जा रही स्प्रेडशीट की पहली शीट ("Sheet1") में यह सोर्स डेटा मौजूद है. पहली पंक्ति में दिए गए स्ट्रिंग अलग-अलग कॉलम के लेबल होते हैं. अपनी स्प्रेडशीट में दूसरी शीट से पढ़ने के तरीके के उदाहरण देखने के लिए, A1 नोटेशन देखें.
| जवाब | B | C | D | E | |
| 1 | मॉडल नंबर | बिक्री - जनवरी | सेल - फ़रवरी | बिक्री - मार्च | कुल बिक्री |
| 2 | D-01X | 68 | 74 | 60 | 202 |
| 3 | FR-0B1 | 97 | 76 | 88 | 261 |
| 4 | P-034 | 27 | 49 | 32 | 108 |
| 5 | P-105 | 46 | 44 | 67 | 157 |
| 6 | W-11 | 75 | 68 | 87 | 230 |
| 7 | W-24 | 74 | 52 | 62 | 188 |
कॉलम चार्ट जोड़ें
यहां दिया गया
spreadsheets.batchUpdate
कोड सैंपल में बताया गया है कि सोर्स डेटा से कॉलम चार्ट बनाने के लिए, AddChartRequest
का इस्तेमाल कैसे किया जाता है. साथ ही, उसे नई शीट में कैसे रखा जाए. चार्ट को कॉन्फ़िगर करने के लिए, अनुरोध ये काम करता है:
- चार्ट के टाइप को कॉलम चार्ट के तौर पर सेट करता है.
- चार्ट के निचले हिस्से में लेजेंड जोड़ता है.
- चार्ट और ऐक्सिस का टाइटल सेट करता है.
- यह तीन डेटा सीरीज़ कॉन्फ़िगर करती है, जो तीन अलग-अलग महीनों की बिक्री को दिखाती हैं. साथ ही, डिफ़ॉल्ट फ़ॉर्मैटिंग और कलर का इस्तेमाल करती हैं.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"addChart": {
"chart": {
"spec": {
"title": "Model Q1 Sales",
"basicChart": {
"chartType": "COLUMN",
"legendPosition": "BOTTOM_LEGEND",
"axis": [
{
"position": "BOTTOM_AXIS",
"title": "Model Numbers"
},
{
"position": "LEFT_AXIS",
"title": "Sales"
}
],
"domains": [
{
"domain": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 0,
"endColumnIndex": 1
}
]
}
}
}
],
"series": [
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 1,
"endColumnIndex": 2
}
]
}
},
"targetAxis": "LEFT_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 2,
"endColumnIndex": 3
}
]
}
},
"targetAxis": "LEFT_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 3,
"endColumnIndex": 4
}
]
}
},
"targetAxis": "LEFT_AXIS"
}
],
"headerCount": 1
}
},
"position": {
"newSheet": true
}
}
}
}
]
}
अनुरोध, इस तरह की नई शीट में एक चार्ट बनाता है:
पाई चार्ट जोड़ना
यहां दिया गया
spreadsheets.batchUpdate
कोड सैंपल में बताया गया है कि सोर्स डेटा से 3D पाई चार्ट बनाने के लिए, AddChartRequest
का इस्तेमाल कैसे किया जाता है. चार्ट को कॉन्फ़िगर करने के लिए, अनुरोध ये काम करता है:
- चार्ट का टाइटल सेट करता है.
- चार्ट की दाईं ओर लेजेंड जोड़ता है.
- चार्ट को 3D पाई चार्ट के तौर पर सेट करता है. ध्यान दें कि 3D पाई चार्ट के बीच में "डोनट होल" उस तरह नहीं हो सकता, जिस तरह फ़्लैट पाई चार्ट में हो सकता है.
- यह चार्ट डेटा सीरीज़ को, हर मॉडल नंबर की कुल बिक्री के तौर पर सेट करता है.
- SHEET_ID की बताई गई शीट के सेल C3 पर चार्ट को ऐंकर करता है. इसमें X और Y, दोनों ही निर्देशों में 50 पिक्सल ऑफ़सेट होता है.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"addChart": {
"chart": {
"spec": {
"title": "Model Q1 Total Sales",
"pieChart": {
"legendPosition": "RIGHT_LEGEND",
"threeDimensional": true,
"domain": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 0,
"endColumnIndex": 1
}
]
}
},
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 7,
"startColumnIndex": 4,
"endColumnIndex": 5
}
]
}
},
}
},
"position": {
"overlayPosition": {
"anchorCell": {
"sheetId": SHEET_ID,
"rowIndex": 2,
"columnIndex": 2
},
"offsetXPixels": 50,
"offsetYPixels": 50
}
}
}
}
}
]
}
अनुरोध करने पर इस तरह का चार्ट बनता है:
इसके अलावा, अनुरोध में लेजेंड पोज़िशन की वैल्यू को RIGHT_LEGEND से LABELED_LEGEND में अपडेट भी किया जा सकता है, ताकि लेजेंड की वैल्यू पाई चार्ट स्लाइस से कनेक्ट की जा सकें.
'legendPosition': 'LABELED_LEGEND',
अपडेट किया गया अनुरोध इस तरह का चार्ट बनाता है:
एक से ज़्यादा रेंज का इस्तेमाल करके लाइन चार्ट जोड़ना
यहां दिया गया
spreadsheets.batchUpdate
कोड सैंपल में बताया गया है कि सोर्स डेटा से लाइन चार्ट बनाने के लिए, AddChartRequest
का इस्तेमाल कैसे किया जाता है. इस डेटा को सोर्स शीट में रखा जाता है.
ChartSourceRange से पंक्तियां बाहर रखने के लिए, मिलती-जुलती रेंज को चुनने का इस्तेमाल किया जा सकता है.
चार्ट को कॉन्फ़िगर करने के लिए, अनुरोध ये काम करता है:
- चार्ट के टाइप को लाइन चार्ट के तौर पर सेट करता है.
- हॉरिज़ॉन्टल x-ऐक्सिस का टाइटल सेट करता है.
- यह नीति बिक्री को दिखाने वाली डेटा सीरीज़ को कॉन्फ़िगर करती है. यह A1:A3 और A6:A7 को
domain, और B1:B3, और B6:B7 कोseriesके तौर पर सेट करता है. साथ ही, डिफ़ॉल्ट फ़ॉर्मैटिंग और कलर का इस्तेमाल करता है. रेंज को अनुरोध के यूआरएल में A1 नोटेशन का इस्तेमाल करके दिखाया जाता है. - SHEET_ID की तय की गई शीट के H8 सेल पर चार्ट को ऐंकर करता है.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"addChart": {
"chart": {
"spec": {
"basicChart": {
"chartType": "LINE",
"domains": [
{
"domain": {
"sourceRange": {
"sources": [
{
"startRowIndex": 0,
"endRowIndex": 3,
"startColumnIndex": 0,
"endColumnIndex": 1,
"sheetId": SOURCE_SHEET_ID
},
{
"startRowIndex": 5,
"endRowIndex": 7,
"startColumnIndex": 0,
"endColumnIndex": 1,
"sheetId": SOURCE_SHEET_ID
}
]
}
}
}
],
"series": [
{
"series": {
"sourceRange": {
"sources": [
{
"startRowIndex": 0,
"endRowIndex": 3,
"startColumnIndex": 1,
"endColumnIndex": 2,
"sheetId": SOURCE_SHEET_ID
},
{
"startRowIndex": 5,
"endRowIndex": 7,
"startColumnIndex": 1,
"endColumnIndex": 2,
"sheetId": SOURCE_SHEET_ID
}
]
}
}
}
]
}
},
"position": {
"overlayPosition": {
"anchorCell": {
"sheetId": SOURCE_SHEET_ID,
"rowIndex": 8,
"columnIndex": 8
}
}
}
}
}
}
]
}
अनुरोध, इस तरह की नई शीट में एक चार्ट बनाता है:
चार्ट मिटाना
यहां दिया गया spreadsheets.batchUpdate कोड सैंपल, DeleteEmbeddedObjectRequest को इस्तेमाल करने का तरीका बताता है, ताकि CHART_ID के ज़रिए बताए गए चार्ट को मिटाया जा सके.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"deleteEmbeddedObject": {
"objectId": CHART_ID
}
}
]
}
चार्ट की प्रॉपर्टी में बदलाव करना
यहां दिया गया
spreadsheets.batchUpdate
कोड सैंपल में बताया गया है कि
UpdateChartSpecRequest
कॉलम चार्ट जोड़ें रेसिपी में बनाए गए चार्ट में बदलाव करने के लिए कैसे
UpdateChartSpecRequest का इस्तेमाल किया जाए. साथ ही, इसके डेटा, टाइप, और दिखने के तरीके में बदलाव भी किया जा सकता है. चार्ट प्रॉपर्टी के सबसेट अलग-अलग नहीं बदले जा सकते. बदलाव करने के लिए, आपको UpdateChartSpecRequest के साथ पूरे spec फ़ील्ड में बदलाव करना होगा. इसलिए, चार्ट की खास बातों में बदलाव करने के लिए, उसकी जगह कोई नया चार्ट जोड़ना ज़रूरी है.
नीचे दिए गए अनुरोध से मूल चार्ट (CHART_ID में बताया गया) को अपडेट किया जाता है:
- चार्ट के टाइप को
BARपर सेट करता है. - लेजेंड को चार्ट के दाईं ओर ले जाता है.
- ऐक्सिस को उलटा करता है, ताकि "बिक्री" निचले ऐक्सिस पर और "मॉडल नंबर" बाएं ऐक्सिस पर रहे.
- ऐक्सिस के टाइटल के फ़ॉर्मैट को 24 पॉइंट वाले फ़ॉन्ट, बोल्ड, और इटैलिक फ़ॉर्मैट में सेट करता है.
- चार्ट से "W-24" डेटा को हटाता है (चार्ट सोर्स डेटा में पंक्ति 7).
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateChartSpec": {
"chartId": CHART_ID,
"spec": {
"title": "Model Q1 Sales",
"basicChart": {
"chartType": "BAR",
"legendPosition": "RIGHT_LEGEND",
"axis": [
{
"format": {
"bold": true,
"italic": true,
"fontSize": 24
},
"position": "BOTTOM_AXIS",
"title": "Sales"
},
{
"format": {
"bold": true,
"italic": true,
"fontSize": 24
},
"position": "LEFT_AXIS",
"title": "Model Numbers"
}
],
"domains": [
{
"domain": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 1
}
]
}
}
}
],
"series": [
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 6,
"startColumnIndex": 1,
"endColumnIndex": 2
}
]
}
},
"targetAxis": "BOTTOM_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 6,
"startColumnIndex": 2,
"endColumnIndex": 3
}
]
}
},
"targetAxis": "BOTTOM_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"sheetId": SOURCE_SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 6,
"startColumnIndex": 3,
"endColumnIndex": 4
}
]
}
},
"targetAxis": "BOTTOM_AXIS"
}
],
"headerCount": 1
}
}
}
}
]
}
अनुरोध के बाद चार्ट कुछ ऐसा दिखता है:
चार्ट को एक जगह से दूसरी जगह ले जाना या उसका साइज़ बदलना
यहां दिए गए
spreadsheets.batchUpdate
कोड सैंपल में, चार्ट को एक जगह से दूसरी जगह ले जाने और उसका साइज़ बदलने के लिए, UpdateEmbeddedObjectPositionRequest को इस्तेमाल करने का तरीका बताया गया है. अनुरोध के बाद, CHART_ID ने जो चार्ट तय किया है वह है:
- अपनी ओरिजनल शीट के सेल A5 पर ऐंकर किया गया.
- X दिशा में 100 पिक्सल का ऑफ़सेट.
- साइज़ को बदलकर 1200 x 742 पिक्सल किया गया (चार्ट का डिफ़ॉल्ट साइज़ 600 x 371 पिक्सल है).
अनुरोध सिर्फ़ उन प्रॉपर्टी में बदलाव करता है जिनके बारे में fields पैरामीटर ने बताया है.
अन्य प्रॉपर्टी (जैसे कि offsetYPixels) की मूल वैल्यू बनी रहती है.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateEmbeddedObjectPosition": {
"objectId": CHART_ID,
"newPosition": {
"overlayPosition": {
"anchorCell": {
"rowIndex": 4,
"columnIndex": 0
},
"offsetXPixels": 100,
"widthPixels": 1200,
"heightPixels": 742
}
},
"fields": "anchorCell(rowIndex,columnIndex),offsetXPixels,widthPixels,heightPixels"
}
}
]
}
चार्ट डेटा पढ़ें
नीचे दिया गया spreadsheets.get कोड सैंपल बताता है कि स्प्रेडशीट से चार्ट का डेटा कैसे लिया जाता है. fields क्वेरी पैरामीटर से यह तय होता है कि सिर्फ़ चार्ट का डेटा दिखाया जाना चाहिए.
इस मेथड कॉल का रिस्पॉन्स एक
spreadsheet
ऑब्जेक्ट है, जिसमें sheet ऑब्जेक्ट का कलेक्शन होता है. शीट पर मौजूद सभी चार्ट, sheet ऑब्जेक्ट में दिखते हैं. अगर जवाब वाले फ़ील्ड को डिफ़ॉल्ट वैल्यू पर सेट किया गया है, तो उसे रिस्पॉन्स में शामिल नहीं किया जाता.
इस उदाहरण में, पहली शीट (SOURCE_SHEET_ID) में कोई चार्ट नहीं है, इसलिए कर्ली ब्रेसेस का एक खाली जोड़ा दिया गया है. दूसरी शीट में कॉलम चार्ट जोड़ें से बनाया गया चार्ट होता है, न कि कुछ और.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?fields=sheets(charts)
{
"sheets": [
{},
{
"charts": [
{
"chartId": CHART_ID,
"position": {
"sheetId": SHEET_ID
},
"spec": {
"basicChart": {
"axis": [
{
"format": {
"bold": false,
"italic": false
},
"position": "BOTTOM_AXIS",
"title": "Model Numbers"
},
{
"format": {
"bold": false,
"italic": false
},
"position": "LEFT_AXIS",
"title": "Sales"
}
],
"chartType": "COLUMN",
"domains": [
{
"domain": {
"sourceRange": {
"sources": [
{
"endColumnIndex": 1
"endRowIndex": 7,
"sheetId": SOURCE_SHEET_ID,
"startColumnIndex": 0,
"startRowIndex": 0,
}
]
}
}
}
],
"legendPosition": "BOTTOM_LEGEND",
"series": [
{
"series": {
"sourceRange": {
"sources": [
{
"endColumnIndex": 2,
"endRowIndex": 7,
"sheetId": SOURCE_SHEET_ID,
"startColumnIndex": 1,
"startRowIndex": 0,
}
]
}
},
"targetAxis": "LEFT_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"endColumnIndex": 3,
"endRowIndex": 7,
"sheetId": SOURCE_SHEET_ID,
"startColumnIndex": 2,
"startRowIndex": 0,
}
]
}
},
"targetAxis": "LEFT_AXIS"
},
{
"series": {
"sourceRange": {
"sources": [
{
"endColumnIndex": 4,
"endRowIndex": 7,
"sheetId": SOURCE_SHEET_ID,
"startColumnIndex": 3,
"startRowIndex": 0,
}
]
}
},
"targetAxis": "LEFT_AXIS"
}
]
},
"hiddenDimensionStrategy": "SKIP_HIDDEN_ROWS_AND_COLUMNS",
"title": "Model Q1 Sales",
},
}
]
}
]
}