उस चार्ट को दिखाता है जिसे स्प्रेडशीट में एम्बेड किया गया है.
इस उदाहरण में, मौजूदा चार्ट में बदलाव करने का तरीका बताया गया है:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A2:B8") var chart = sheet.getCharts()[0]; chart = chart.modify() .addRange(range) .setOption('title', 'Updated!') .setOption('animation.duration', 500) .setPosition(2,2,0,0) .build(); sheet.updateChart(chart);
इस उदाहरण में, नया चार्ट बनाने का तरीका बताया गया है:
function newChart(range, sheet) { var sheet = SpreadsheetApp.getActiveSheet(); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build()); }
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
asDataSourceChart() | DataSourceChart | अगर चार्ट, डेटा सोर्स चार्ट है, तो यह डेटा सोर्स चार्ट के इंस्टेंस पर कास्ट करता है या null
नहीं. |
getAs(contentType) | Blob | इस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं. |
getBlob() | Blob | इस ऑब्जेक्ट के अंदर का डेटा, ब्लॉब के तौर पर दें. |
getChartId() | Integer | चार्ट के लिए स्टेबल आइडेंटिफ़ायर, जो चार्ट वाली स्प्रेडशीट पर यूनीक होता है. अगर चार्ट किसी स्प्रेडशीट में नहीं है, तो null दिखाता है. |
getContainerInfo() | ContainerInfo | यह जानकारी दिखाता है कि शीट में चार्ट को कहां रखा गया है. |
getHiddenDimensionStrategy() | ChartHiddenDimensionStrategy | छिपी हुई पंक्तियों और कॉलम को हैंडल करने के लिए इस्तेमाल की जाने वाली रणनीति दिखाता है. |
getMergeStrategy() | ChartMergeStrategy | एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति दिखाता है. |
getNumHeaders() | Integer | पंक्तियों या कॉलम की संख्या दिखाता है, जो हेडर के तौर पर मानी जाती है. |
getOptions() | ChartOptions | इस चार्ट के लिए विकल्प दिखाता है, जैसे कि ऊंचाई, रंग, और ऐक्सिस. |
getRanges() | Range[] | उन रेंज को दिखाता है जिनका इस्तेमाल इस चार्ट में, डेटा सोर्स के तौर पर किया जाता है. |
getTransposeRowsAndColumns() | Boolean | अगर true हो, तो चार्ट को पॉप्युलेट करने के लिए इस्तेमाल की जाने वाली पंक्तियां और कॉलम स्विच हो जाते हैं. |
modify() | EmbeddedChartBuilder | इससे EmbeddedChartBuilder मिलता है, जिसका इस्तेमाल इस चार्ट में बदलाव करने के लिए किया जा सकता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
asDataSourceChart()
अगर चार्ट, डेटा सोर्स चार्ट है, तो यह डेटा सोर्स चार्ट के इंस्टेंस पर कास्ट करता है या null
नहीं.
रिटर्न
DataSourceChart
— डेटा सोर्स चार्ट.
getAs(contentType)
इस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं. इस तरीका से फ़ाइल नाम में सही एक्सटेंशन जोड़ा जा सकता है—उदाहरण के लिए, "myfile.pdf". हालांकि, यह माना जाता है कि फ़ाइल नाम का वह हिस्सा जो पिछली अवधि (अगर कोई है) के बाद आता है, तो वह मौजूदा एक्सटेंशन है जिसे बदला जाना चाहिए. इस वजह से, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" हो जाता है.
कन्वर्ज़न के रोज़ के कोटा देखने के लिए, Google Services के लिए कोटा देखें. हाल ही में बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए सख्त कोटे लागू हो सकते हैं.
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
contentType | String | वह MIME टाइप जिसमें बदलना है. ज़्यादातर ब्लॉब के लिए, सिर्फ़ 'application/pdf' ही मान्य विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट में मौजूद इमेज के लिए, 'image/bmp' , 'image/gif' , 'image/jpeg' या 'image/png' में से कोई भी मान्य है. |
रिटर्न
Blob
— ब्लॉब के तौर पर डेटा.
getBlob()
getChartId()
चार्ट के लिए स्टेबल आइडेंटिफ़ायर, जो चार्ट वाली स्प्रेडशीट पर यूनीक होता है. अगर चार्ट किसी स्प्रेडशीट में नहीं है, तो null
दिखाता है.
रिटर्न
Integer
— चार्ट का स्थायी आइडेंटिफ़ायर.
getContainerInfo()
यह जानकारी दिखाता है कि शीट में चार्ट को कहां रखा गया है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var containerInfo = chart.getContainerInfo(); // Logs the values we used in setPosition() Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s", containerInfo.getAnchorColumn(), containerInfo.getAnchorRow(), containerInfo.getOffsetX(), containerInfo.getOffsetY());
रिटर्न
ContainerInfo
— ऐसा ऑब्जेक्ट जिसमें चार्ट कंटेनर की पोज़िशन मौजूद है
getHiddenDimensionStrategy()
छिपी हुई पंक्तियों और कॉलम को हैंडल करने के लिए इस्तेमाल की जाने वाली रणनीति दिखाता है. डिफ़ॉल्ट तौर पर, यह वैल्यू IGNORE_ROWS
होती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS) .setPosition(5, 5, 0, 0) .build() // Logs the strategy to use for hidden rows and columns which is // Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case. Logger.log(chart.getHiddenDimensionStrategy());
रिटर्न
ChartHiddenDimensionStrategy
— छिपी हुई पंक्तियों और कॉलम के लिए इस्तेमाल की जाने वाली रणनीति.
getMergeStrategy()
एक से ज़्यादा रेंज मौजूद होने पर, मर्ज करने की रणनीति दिखाता है. MERGE_ROWS
होने पर, पंक्ति मर्ज कर दी जाती है; MERGE_COLUMNS
होने पर, कॉलम मर्ज कर दिए जाते हैं. डिफ़ॉल्ट तौर पर, यह वैल्यू MERGE_COLUMNS
होती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B10"); var range2 = sheet.getRange("C1:C10"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .addRange(range2) .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS) .setPosition(5, 5, 0, 0) .build() // Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this case. Logger.log(chart.getMergeStrategy());
रिटर्न
ChartMergeStrategy
— अगर पंक्तियों को कई रेंज में मर्ज किया गया है, तो MERGE_ROWS
; अगर कॉलम कई रेंज में मर्ज किए गए हैं, तो MERGE_COLUMNS
getNumHeaders()
पंक्तियों या कॉलम की संख्या दिखाता है, जो हेडर के तौर पर मानी जाती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(range) .setNumHeaders(1) .setPosition(5, 5, 0, 0) .build() // Logs the number of rows or columns to use as headers, which is 1 in this case. Logger.log(chart.getHeaders());
रिटर्न
Integer
— पंक्तियों या कॉलम की संख्या, जिन्हें हेडर माना जाता है. नेगेटिव वैल्यू से पता चलता है कि हेडर
की पहचान अपने-आप कर ली गई है.
getOptions()
इस चार्ट के लिए विकल्प दिखाता है, जैसे कि ऊंचाई, रंग, और ऐक्सिस.
लौटाए गए विकल्पों को बदला नहीं जा सकता.
रिटर्न
ChartOptions
— इस चार्ट के लिए विकल्प, जैसे कि ऊंचाई, रंग, और ऐक्सिस.
getRanges()
उन रेंज को दिखाता है जिनका इस्तेमाल इस चार्ट में, डेटा सोर्स के तौर पर किया जाता है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B8")) .setPosition(5, 5, 0, 0) .build(); var ranges = chart.getRanges(); // There's only one range as a data source for this chart, // so this logs "A1:B8" for (var i in ranges) { var range = ranges[i]; Logger.log(range.getA1Notation()); }
रिटर्न
Range[]
— रेंज का ऐसा कलेक्शन जो इस चार्ट के डेटा सोर्स के तौर पर काम करता है
getTransposeRowsAndColumns()
अगर true
हो, तो चार्ट को पॉप्युलेट करने के लिए इस्तेमाल की जाने वाली पंक्तियां और कॉलम स्विच हो जाते हैं. डिफ़ॉल्ट तौर पर, यह वैल्यू
false
होती है.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B5"); var chart = sheet.newChart() .addRange(range) .setChartType(Charts.ChartType.BAR) .setTransposeRowsAndColumns(true) .setPosition(5, 5, 0, 0) .build() // Logs whether rows and columns should be transposed, which is true in this case. Logger.log(chart.getTransposeRowsAndColumns());
रिटर्न
Boolean
— true
अगर चार्ट बनाने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को ट्रांसपोज़ किया गया है.
modify()
इससे EmbeddedChartBuilder
मिलता है, जिसका इस्तेमाल इस चार्ट में बदलाव करने के लिए किया जा सकता है. किसी भी बदलाव को सेव करने के लिए, sheet.updateChart(chart)
को शुरू करें.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.getCharts()[0]; chart = chart.modify() .setOption('width', 800) .setOption('height', 640) .setPosition(5, 5, 0, 0) .build(); sheet.updateChart(chart);
रिटर्न
EmbeddedChartBuilder
— एम्बेड किए गए चार्ट बनाने के लिए बिल्डर