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इस ऑब्जेक्ट में मौजूद डेटा को ब्लॉब के तौर पर दिखाएं.
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 — डेटा को ब्लॉब के तौर पर दिखाया गया है.


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

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());

वापसी का टिकट

ChartMergeStrategyMERGE_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());

वापसी का टिकट

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


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