Class EmbeddedChart

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अगर चार्ट, डेटा सोर्स चार्ट है, तो यह डेटा सोर्स चार्ट के इंस्टेंस में बदल जाता है. वहीं, अगर चार्ट डेटा सोर्स चार्ट नहीं है, तो यह null में बदल जाता है.
getAs(contentType)Blobइस ऑब्जेक्ट में मौजूद डेटा को, बताए गए कॉन्टेंट टाइप में बदलकर, blob के तौर पर दिखाता है.
getBlob()Blobइस ऑब्जेक्ट में मौजूद डेटा को blob के तौर पर दिखाता है.
getChartId()Integer|nullचार्ट के लिए एक स्थायी आइडेंटिफ़ायर दिखाता है. यह आइडेंटिफ़ायर, चार्ट वाली स्प्रेडशीट में यूनीक होता है. अगर चार्ट किसी स्प्रेडशीट में नहीं है, तो यह null दिखाता है.
getContainerInfo()ContainerInfoयह जानकारी दिखाता है कि चार्ट, शीट में कहां मौजूद है.
getHiddenDimensionStrategy()ChartHiddenDimensionStrategyछुपी हुई पंक्तियों और कॉलम को मैनेज करने के लिए इस्तेमाल की जाने वाली रणनीति दिखाता है.
getMergeStrategy()ChartMergeStrategyएक से ज़्यादा रेंज होने पर, इस्तेमाल की जाने वाली मर्ज रणनीति दिखाता है.
getNumHeaders()Integerयह उन पंक्तियों या कॉलम की संख्या दिखाता है जिन्हें हेडर के तौर पर इस्तेमाल किया जाता है.
getOptions()ChartOptionsयह चार्ट के विकल्प दिखाता है. जैसे, ऊंचाई, रंग, और ऐक्सिस.
getRanges()Range[]यह उन रेंज को दिखाता है जिनका इस्तेमाल, चार्ट डेटा सोर्स के तौर पर करता है.
getTransposeRowsAndColumns()Booleanअगर वैल्यू true है, तो चार्ट में डेटा भरने के लिए इस्तेमाल की गई पंक्तियों और कॉलम को स्विच किया जाता है.
modify()EmbeddedChartBuilderयह EmbeddedChartBuilder दिखाता है. इसका इस्तेमाल, इस चार्ट में बदलाव करने के लिए किया जा सकता है.

ज़्यादा जानकारी वाला दस्तावेज़

asDataSourceChart()

अगर चार्ट, डेटा सोर्स चार्ट है, तो यह डेटा सोर्स चार्ट के इंस्टेंस में बदल जाता है. वहीं, अगर चार्ट डेटा सोर्स चार्ट नहीं है, तो यह null में बदल जाता है.

वापसी का टिकट

DataSourceChart|null — डेटा सोर्स चार्ट.

getAs(contentType)

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

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

पैरामीटर

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

वापसी का टिकट

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

getBlob()

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

वापसी का टिकट

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

getChartId()

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

वापसी का टिकट

Integer|null — चार्ट का एक स्थायी आइडेंटिफ़ायर.

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