Class EmbeddedChart

एम्बेड किया गयाचार्ट

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

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

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let 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) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const 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इस ऑब्जेक्ट में मौजूद डेटा को 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 की सेवाओं के लिए कोटे देखें. नए Google Workspace डोमेन पर, कुछ समय के लिए ज़्यादा पाबंदियां लागू हो सकती हैं.

पैरामीटर

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

वापसी का टिकट

Blob — डेटा को एक बड़े बाइनरी ऑब्जेक्ट के तौर पर दिखाया जाता है.

getBlob()

इस ऑब्जेक्ट में मौजूद डेटा को blob के तौर पर दिखाओ.

वापसी का टिकट

Blob — डेटा को एक बड़े बाइनरी ऑब्जेक्ट के तौर पर दिखाया जाता है.

getChartId()

यह फ़ंक्शन, चार्ट के लिए एक स्टेबल आइडेंटिफ़ायर दिखाता है. यह आइडेंटिफ़ायर, चार्ट वाली स्प्रेडशीट में यूनीक होता है. अगर चार्ट किसी स्प्रेडशीट में नहीं है, तो यह null दिखाता है.

वापसी का टिकट

Integer — यह चार्ट का स्टेबल आइडेंटिफ़ायर होता है.

getContainerInfo()

यह फ़ंक्शन, किसी शीट में चार्ट की पोज़िशन की जानकारी देता है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const containerInfo = chart.getContainerInfo();

// Logs the values 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 पर सेट होती है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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 पर सेट होती है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const 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()

यह फ़ंक्शन, हेडर के तौर पर इस्तेमाल की जाने वाली रेंज में मौजूद पंक्तियों या कॉलम की संख्या दिखाता है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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()

यह फ़ंक्शन, उन रेंज को दिखाता है जिनका इस्तेमाल यह चार्ट डेटा सोर्स के तौर पर करता है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

वापसी का टिकट

Range[] — रेंज का एक ऐसा कलेक्शन जो इस चार्ट के डेटा सोर्स के तौर पर काम करता है.

getTransposeRowsAndColumns()

अगर true है, तो चार्ट में डेटा भरने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को बदल दिया जाता है. डिफ़ॉल्ट रूप से, यह false पर सेट होती है. 

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const 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) को लागू करें. 

const sheet = SpreadsheetApp.getActiveSheet();
let chart = sheet.getCharts()[0];
chart = chart.modify()
            .setOption('width', 800)
            .setOption('height', 640)
            .setPosition(5, 5, 0, 0)
            .build();
sheet.updateChart(chart);

वापसी का टिकट

EmbeddedChartBuilder — एम्बेड किए गए चार्ट बनाने के लिए बिल्डर.