এটি এমন একটি চার্টকে বোঝায় যা একটি স্প্রেডশিটে অন্তর্ভুক্ত করা হয়েছে।
এই উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান চার্ট পরিবর্তন করতে হয়:
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()); }
পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
as Data Source Chart() | Data Source Chart |null | চার্টটি ডেটা সোর্স চার্ট হলে একটি ডেটা সোর্স চার্ট ইনস্ট্যান্সে কাস্ট করে, অন্যথায় null কাস্ট করে। |
get As(contentType) | Blob | এই অবজেক্টের ভেতরের ডেটা নির্দিষ্ট কন্টেন্ট টাইপে রূপান্তরিত একটি ব্লব হিসেবে ফেরত দিন। |
get Blob() | Blob | এই অবজেক্টের ভেতরের ডেটা একটি ব্লব হিসেবে ফেরত দিন। |
get Chart Id() | Integer|null | চার্টটির জন্য একটি স্থিতিশীল শনাক্তকারী প্রদান করে যা চার্টটি ধারণকারী স্প্রেডশীট জুড়ে অনন্য, অথবা চার্টটি কোনো স্প্রেডশীটে না থাকলে null প্রদান করে। |
get Container Info() | Container Info | একটি শীটের মধ্যে চার্টটি কোথায় অবস্থিত, সে সম্পর্কে তথ্য প্রদান করে। |
get Hidden Dimension Strategy() | Chart Hidden Dimension Strategy | লুকানো সারি এবং কলামগুলি পরিচালনা করার জন্য ব্যবহারযোগ্য কৌশলটি ফেরত দেয়। |
get Merge Strategy() | Chart Merge Strategy | একাধিক রেঞ্জ বিদ্যমান থাকলে ব্যবহৃত মার্জ কৌশলটি ফেরত দেয়। |
get Num Headers() | Integer | রেঞ্জটির মধ্যে থাকা যে সারি বা কলামগুলোকে হেডার হিসেবে গণ্য করা হয়, তার সংখ্যা ফেরত দেয়। |
get Options() | Chart Options | এই চার্টের বিকল্পগুলো, যেমন উচ্চতা, রং এবং অক্ষগুলো ফেরত দেয়। |
get Ranges() | Range[] | এই চার্টটি ডেটা উৎস হিসেবে যে পরিসরগুলো ব্যবহার করে, তা ফেরত দেয়। |
get Transpose Rows And Columns() | Boolean | যদি true , তাহলে চার্টটি পূরণ করতে ব্যবহৃত সারি এবং কলামগুলি অদলবদল করা হয়। |
modify() | Embedded Chart Builder | একটি Embedded Chart Builder ফেরত দেয় যা এই চার্টটি পরিবর্তন করতে ব্যবহার করা যেতে পারে। |
বিস্তারিত ডকুমেন্টেশন
asDataSourceChart()
চার্টটি ডেটা সোর্স চার্ট হলে একটি ডেটা সোর্স চার্ট ইনস্ট্যান্সে কাস্ট করে, অন্যথায় null কাস্ট করে।
ফেরত
DataSourceChart |null — ডেটা সোর্স চার্ট।
getAs(contentType)
এই অবজেক্টের ভেতরের ডেটা নির্দিষ্ট কন্টেন্ট টাইপে রূপান্তরিত একটি ব্লব হিসেবে ফেরত দিন। এই মেথডটি ফাইলের নামের সাথে উপযুক্ত এক্সটেনশন যোগ করে—উদাহরণস্বরূপ, "myfile.pdf"। তবে, এটি ধরে নেয় যে ফাইলের নামের শেষ পিরিয়ডের (যদি থাকে) পরের অংশটি একটি বিদ্যমান এক্সটেনশন যা প্রতিস্থাপন করা উচিত। ফলস্বরূপ, "ShoppingList.12.25.2014" হয়ে যায় "ShoppingList.12.25.pdf"।
রূপান্তরের দৈনিক কোটা দেখতে, ‘গুগল পরিষেবার জন্য কোটা’ দেখুন। নতুন তৈরি করা গুগল ওয়ার্কস্পেস ডোমেনগুলো সাময়িকভাবে আরও কঠোর কোটার আওতাভুক্ত হতে পারে।
প্যারামিটার
| নাম | প্রকার | বর্ণনা |
|---|---|---|
content Type | String | যে MIME টাইপে রূপান্তর করতে হবে। বেশিরভাগ ব্লবের জন্য, 'application/pdf' হলো একমাত্র বৈধ বিকল্প। BMP, GIF, JPEG, বা PNG ফরম্যাটের ছবির জন্য, 'image/bmp' , 'image/gif' , 'image/jpeg' , বা 'image/png' এর যেকোনো একটিও বৈধ। একটি গুগল ডক্স ডকুমেন্টের জন্য, 'text/markdown' ও বৈধ। |
ফেরত
Blob — ডেটা একটি পিণ্ডাকারে থাকে।
getBlob()
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_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 — এমবেডেড চার্ট তৈরির একটি বিল্ডার।