ตัวสร้างสำหรับออบเจ็กต์ Data
ต่อไปนี้คือตัวอย่างการใช้เครื่องมือสร้าง ระบบจะนําเข้าข้อมูลจากสเปรดชีตใน Google ชีต
function doGet() { // This example creates two table charts side by side. One uses a data view // definition to restrict the number of displayed columns. // Get sample data from a spreadsheet. const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; // Create a chart to display all of the data. const originalChart = Charts.newTableChart() .setDimensions(600, 500) .setDataSourceUrl(dataSourceUrl) .build(); // Create another chart to display a subset of the data (only columns 1 and // 4). const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]); const limitedChart = Charts.newTableChart() .setDimensions(200, 500) .setDataSourceUrl(dataSourceUrl) .setDataViewDefinition(dataViewDefinition) .build(); const htmlOutput = HtmlService.createHtmlOutput(); const originalChartData = Utilities.base64Encode( originalChart.getAs('image/png').getBytes(), ); const originalChartUrl = `data:image/png;base64,${encodeURI(originalChartData)}`; const limitedChartData = Utilities.base64Encode( limitedChart.getAs('image/png').getBytes(), ); const limitedChartUrl = `data:image/png;base64,${encodeURI(limitedChartData)}`; htmlOutput.append('<table><tr><td>'); htmlOutput.append(`<img border="1" src="${originalChartUrl}">`); htmlOutput.append('</td><td>'); htmlOutput.append(`<img border="1" src="${limitedChartUrl}">`); htmlOutput.append('</td></tr></table>'); return htmlOutput; }
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
build() | Data | สร้างและแสดงผลออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้ |
set | Data | กำหนดดัชนีของคอลัมน์ที่จะรวมไว้ในมุมมองข้อมูล รวมถึงระบุข้อมูลคอลัมน์บทบาท |
เอกสารประกอบโดยละเอียด
build()
สร้างและแสดงผลออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้
รีเทิร์น
Data
— ออบเจ็กต์คําจํากัดความของมุมมองข้อมูลที่สร้างขึ้นโดยใช้เครื่องมือสร้างนี้
set Columns(columns)
กำหนดดัชนีของคอลัมน์ที่จะรวมไว้ในมุมมองข้อมูล รวมถึงระบุข้อมูลคอลัมน์บทบาท ชุดย่อยของดัชนีคอลัมน์นี้หมายถึงคอลัมน์ของแหล่งข้อมูลที่มุมมองข้อมูลมาจาก
บทบาทของคอลัมน์จะอธิบายวัตถุประสงค์ของข้อมูลในคอลัมน์นั้น เช่น คอลัมน์หนึ่งๆ อาจเก็บข้อมูลอธิบายข้อความเคล็ดลับเครื่องมือ คําอธิบายประกอบจุดข้อมูล หรือตัวบ่งชี้ความไม่แน่นอน โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อบทบาทตาราง
สมมติว่าสเปรดชีตมีข้อมูลต่อไปนี้ใน A1:C3
'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';
const COLUMN_SPEC = [ 0, // categories 1, // counts {sourceColumn: 2, role: 'style'}, ]; function roleColumnChart() { const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getActiveSheet(); const viewSpec = Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build(); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .setDataViewDefinition(viewSpec) .setOption('useFirstColumnAsDomain', true) .setPosition(5, 1, 0, 0) .setOption('hAxis', {title: 'Counts'}) .setOption('vAxis', {title: 'Categories'}) .addRange(sheet.getRange('A1:C3')); sheet.insertChart(chartBuilder.build()); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columns | Object[] | อาร์เรย์ของดัชนีคอลัมน์หรือคําอธิบายคอลัมน์ (ออบเจ็กต์) เพื่อรวมไว้ในมุมมองข้อมูล คำอธิบายคอลัมน์จะกำหนดบทบาทของคอลัมน์ ตารางข้อมูลและการแจกแจงสำหรับคอลัมน์มุมมองข้อมูลจะนับจาก 0 |
รีเทิร์น
Data
— ตัวสร้างนี้มีประโยชน์สำหรับการต่อเชื่อม