इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class EmbeddedChart

यह उस चार्ट को दिखाता है जिसे किसी स्प्रेडशीट में एम्बेड किया गया है.

इस उदाहरण में, मौजूदा चार्ट में बदलाव करने का तरीका बताया गया है:

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`	इस ऑब्जेक्ट के अंदर का डेटा, बताए गए कॉन्टेंट टाइप में बदले गए 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)`

इस ऑब्जेक्ट के अंदर का डेटा, बताए गए कॉन्टेंट टाइप में बदले गए BLOB के तौर पर दिखाएं. यह तरीका, फ़ाइल नाम में सही एक्सटेंशन जोड़ देता है—उदाहरण के लिए, "myfile.pdf". हालांकि, यह मान लेता है कि पिछली अवधि के बाद आने वाला फ़ाइल नाम का हिस्सा (अगर कोई है) पहले से मौजूद है वह एक्सटेंशन जिसे बदला जाना चाहिए. इस वजह से, "ShoppingList.12.25.2014" बन जाती है "ShoppingList.12.25.pdf".

अगर आपको कन्वर्ज़न के लिए हर दिन का कोटा देखना है, तो Google के लिए कोटा सेवाएं. नए Google Workspace डोमेन पर, कुछ समय के लिए पाबंदियां लगाई जा सकती हैं कोटा.

पैरामीटर

नाम	टाइप	ब्यौरा
`contentType`	`String`	वह MIME प्रकार जिसमें बदलना है. ज़्यादातर ब्लॉब के लिए, `'application/pdf'` ही एक विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट वाली इमेज के लिए, `'image/bmp'`, `'image/gif'`, `'image/jpeg'` या `'image/png'` में से कोई भी मान्य. Google Docs के किसी दस्तावेज़ के लिए, `'text/markdown'` भी मान्य है.

वापसी का टिकट

Blob — BLOB के तौर पर डेटा.

`getBlob()`

इस ऑब्जेक्ट के अंदर के डेटा को ब्लॉब के तौर पर दिखाएं.

वापसी का टिकट

Blob — BLOB के तौर पर डेटा.

`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 — एम्बेड किए गए चार्ट बनाने के लिए बिल्डर